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Notices 

© Keysight Technoiogies, Inc. 1996-2019 

No part of this manual may be repro¬ 
duced in any form or by any means 
(including electronic storage and retrieval 
or translation into a foreign language) 
without prior agreement and written con¬ 
sent from Keysight Technologies, Inc. as 
governed by United States and interna¬ 
tional copyright laws. 

Manual Part Number 

El 406-90004 

Edition 

Fifth Edition, August 2019 

Published by 

Keysight Technologies, Inc. 

900 S. Taft Ave. 

Loveland, CO 80537 USA 


Sales and Technical Support 

To contact Keysight for sales and techni¬ 
cal support, refer to the support links on 
the following Keysight websites: 

www.keysight.com/find/El 406A 

(product-specific information and sup¬ 
port, software and documentation 
updates) 

www.keysight.com/find/assist (world¬ 
wide contact information for repair and 
service) 

Declaration of Conformity 

Declarations of Conformity for this prod¬ 
uct and for other Keysight products may 
be downloaded from the Web. Go to 
http://keysight.com/go/conformity and 
click on “Declarations of Conformity.” You 
can then search by product number to 
find the latest Declaration of Conformity. 


Technology Licenses 

The hardware and/or software described 
in this document are furnished under a 
license and may be used or copied only in 
accordance with the terms of such 
license. 


Warranty 

THE MATERIAL CONTAINED IN THIS 
DOCUMENT IS PROVIDED “AS IS.” AND 
IS SUBJECT TO BEING CHANGED, 
WITHOUT NOTICE, IN FUTURE EDI¬ 
TIONS. FURTHER. TO THE MAXIMUM 
EXTENT PERMITTED BY APPLICABLE 
LAW, KEYSIGHT DISCLAIMS ALL WAR¬ 
RANTIES, EITHER EXPRESS OR IMPLIED, 
WITH REGARD TO THIS MANUAL AND 
ANY INFORMATION CONTAINED 
HEREIN, INCLUDING BUT NOT LIMITED 
TO THE IMPLIED WARRANTIES OF MER¬ 
CHANTABILITY AND FITNESS FORA 
PARTICULAR PURPOSE. KEYSIGHT 
SHALL NOT BE LIABLE FOR ERRORS OR 
FOR INCIDENTAL OR CONSEQUENTIAL 
DAMAGES IN CONNECTION WITH THE 
FURNISHING, USE, OR PERFORMANCE 
OFTHIS DOCUMENTOR OFANY INFOR¬ 
MATION CONTAINED HEREIN. SHOULD 
KEYSIGHT AND THE USER HAVE A SEP¬ 
ARATE WRITTEN AGREEMENT WITH 
WARRANTY TERMS COVERING THE 
MATERIAL IN THIS DOCUMENT THAT 
CONFLICT WITH THESE TERMS, THE 
WARRANTY TERMS IN THE SEPARATE 
AGREEMENT SHALL CONTROL. 

Keysight Technologies does not warrant 
third-party system-level (combination of 
chassis, controllers, modules, etc.) per¬ 
formance. safety, or regulatory compli¬ 
ance unless specifically stated. 


DFARS/Restricted Rights 
Notices 

If software Is for use In the performance 
of a U.S. Government prime contract or 
subcontract, Software Is delivered and 
licensed as “Commercial computer soft¬ 
ware” as defined In DFAR 252.227-7014 
(June 1995), or as a “commercial Item” as 
defined In FAR 2.101(a) eras “Restricted 
computer software” as defined In FAR 

52.227- 19 (June 1987) or any equivalent 
agency regulation or contract clause. 

Use. duplication or disclosure of Software 
Is subject to Keysight Technologies’ stan¬ 
dard commercial license terms, and non- 
DOD Departments and Agencies of the 
U.S. Government will receive no greater 
than Restricted Rights as defined In FAR 

52.227- 19(c)(l -2) (June 1987). U.S. Gov¬ 
ernment users will receive no greater 
than Limited Rights as defined In FAR 

52.227- 14 (June 1987) or DFAR 252.227- 
7015 (b)(2) (November 1995), as applica¬ 
ble In any technical data. 


Safety Information 

The foiiowing general safety precau¬ 
tions must be observed during aii 
phases of operation of this instrument. 
Failure to comply with these precau¬ 
tions or with specific warnings or oper¬ 
ating instructions in the product 
manuals violates safety standards of 
design, manufacture, and intended use 
of the instrument. Keysight Technolo¬ 
gies assumes no liability for the cus¬ 
tomer's failure to comply with these 
requirements. 

General 

Do not use this product in any manner not 
specified by the manufacturer. The protec¬ 
tive features of this product must not be 
impaired if it is used in a manner specified in 
the operation instructions. 

Before Applying Power 
Verify that all safety precautions are taken. 
Make all connections to the unit before 
applying power. Note the external markings 
described under “Safety Symbols”. 

Ground the Instrument 

Keysight chassis’ are provided with a 
grounding-type power plug. The 
instrument chassis and cover must be 
connected to an electrical ground to 
minimize shock hazard. The ground pin 
must be firmly connected to an electri¬ 
cal ground (safety ground) terminal at 
the power outlet. Any interruption of 
the protective (grounding) conductor 
or disconnection of the protective 
earth terminal will cause a potential 
shock hazard that could result in per¬ 
sonal injury. 

Do Not Operate in an Explosive 
Atmosphere 

Do not operate the module/chassis in 
the presence of flammable gases or 
fumes. 

Do Not Operate Near Flammable 
Liquids 

Do not operate the module/chassis in 
the presence of flammable liquids or 
near containers of such liquids. 

Cleaning 

Clean the outside of the Keysight mod¬ 
ule/chassis with a soft, lint-free, 
slightly dampened cloth. Do not use 
detergent or chemical solvents. 


Do Not Remove Instrument Cover 

Only qualified, service-trained person¬ 
nel who are aware of the hazards 
involved should remove instrument 
covers. Always disconnect the power 
cable and any external circuits before 
removing the instrument cover. 

Keep away from live circuits 

Operating personnel must not remove 
equipment covers or shields. Proce¬ 
dures involving the removal of covers 
and shields are for use by service- 
trained personnel only. Under certain 
conditions, dangerous voltages may 
exist even with the equipment 
switched off. To avoid dangerous elec¬ 
trical shock, DO NOT perform proce¬ 
dures involving cover or shield removal 
unless you are qualified to do so. 

DO NOT operate damaged 
equipment 

Whenever it is possible that the safety 
protection features built into this prod¬ 
uct have been impaired, either through 
physical damage, excessive moisture, 
or any other reason, REMOVE POWER 
and do not use the product until safe 
operation can be verified by service- 
trained personnel. If necessary, return 
the product to a Keysight Technologies 
Sales and Service Office for service and 
repair to ensure the safety features are 
maintained. 

DO NOT block the primary 
disconnect 

The primary disconnect device is the 
appliance connector/power cord when 
a chassis used by itself, but when 
installed into a rack or system the dis¬ 
connect may be impaired and must be 
considered part of the installation. 

Do Not Modify the Instrument 

Do not install substitute parts or per¬ 
form any unauthorized modification to 
the product. Return the product to a 
Keysight Sales and Service Office to 
ensure that safety features are main¬ 
tained. 

In Case of Damage 

Instruments that appear damaged or 
defective should be made inoperative 
and secured against unintended oper¬ 
ation until they can be repaired by 
qualified service personnel 


CAUTION 


Do NOT block vents and fan exhaust: 
To ensure adequate cooling and venti¬ 
lation, leave a gap of at least 50mm 
(2") around vent holes on both sides of 
the chassis. 

Do NOT operate with empty slots: To 
ensure proper cooling and avoid dam¬ 
aging equipment, fill each empty slot 
with an AXIe filler panel module. 

Do NOT stack free-standing chassis: 
Stacked chassis should be rack¬ 
mounted. 

All modules are grounded through the 
chassis: During installation, tighten 
each module's retaining screws to 
secure the module to the chassis and 
to make the ground connection. 


WARNING 


Operator is responsible to maintain 
safe operating conditions. To ensure 
safe operating conditions, modules 
should not be operated beyond the full 
temperature range specified in the 
Environmental and physical specifica¬ 
tion. Exceeding safe operating condi¬ 
tions can result in shorter lifespan, 
improper module performance and 
user safety issues. When the modules 
are in use and operation within the 
specified full temperature range is not 
maintained, module surface tempera¬ 
tures may exceed safe handling condi¬ 
tions which can cause discomfort or 
burns if touched. In the event of a 
module exceeding the full temperature 
range, always allow the module to cool 
before touching or removing modules 
from the chassis. 


IV 








Safety Symbols 


CAUTION 


A CAUTION denotes a hazard. It 
calls attention to an operating pro¬ 
cedure or practice, that, if not cor¬ 
rectly performed or adhered to 
could result in damage to the 
product or loss of important data. 
Do not proceed beyond a CAUTION 
notice until the indicated condi¬ 
tions are fully understood and met. 


WARNING 


A WARNING denotes a hazard. It 
calls attention to an operating pro¬ 
cedure or practice, that, if not cor¬ 
rectly performed or adhered to, 
could result in personal injury or 
death. Do not proceed beyond a 
WARNING notice until the indi¬ 
cated conditions are fully under¬ 
stood and met. 


Products display the following sym¬ 
bols: 


A Warning, risk of electric 
shock 

A Refer to manual for addi¬ 
tional safety information. 

Earth Ground. 


Chassis Ground. 




Alternating Current (AC). 


Direct Current (DC) 
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Comments.163 
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:DRIVer:LOAD :CHECked.164 

Parameters.164 
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Example.184 

:ECLTrg<n>[:STATe]?.184 

Example.184 

:EXTernal:IMMediate.184 

Comments.184 

Example.184 

:EXTemal:LEVel DiMMediate].185 

Parameters.185 

Comments.185 

Example.185 

:EXTernal:LEVel [:IMMediate]?.185 

Example.185 

:EXTernal:SOURee.186 

Parameters.186 

Comments.186 

Example.186 

:EXTernal:SOURee?.186 

Comments.186 

Example.186 

:EXTernal[:STATe].187 

Parameters.187 

Comments.187 

Example.187 

:EXTernal[:STATe]?.187 

Example.187 

:TTLTrg<n>:IMMediate.188 

Comments.188 

Example.188 

:TTLTrg<n>:LEVel[:IMMediate].188 

Parameters.188 

Comments.188 

Example.189 

:TTLTrg < n >: LEVel[: IM Mediate]?.189 

Comments.189 

Example.189 

:TTLTrg<n>:SOURee.189 
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Comments.191 
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Example.191 

PROGram Subsystem.192 

Subsystem Syntax.192 

[:SELected]:DEFine.192 

Parameters.192 

Comments.192 

[:SELected]:DEFine :CHECked.193 

Parameters.193 

Comments.193 

Byte Format.194 

[:SELected]:DEFine :CHECked?.195 

Comments.195 
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Comments.195 

[:SELeeted]:DELete.196 

Comments.196 

STATUS Subsystem.197 

Subsystem Syntax.197 

:GPERation:CGNDition?.197 

Comments.197 

Example.197 
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:GPERation[:EVENt]?.199 

Comments.199 

Example.199 
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Parameters.200 
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Comments.202 
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Example.202 

:QUEStionable[:EVENt]?.202 

Comments.202 

Example.202 

:QUEStionable:NTRansition.203 

Parameters.203 

Comments.203 

Example.203 

:QUEStionable:PTRansition.203 

Comments.203 

Example.203 

SYSTem Subsystem.204 

Subsystem Syntax.204 

:COMMunicate:GPIB:ADDRess?.205 

Comments.205 

Example.205 

:COMMunicate:SERial[n]:?.205 

Comments.205 

Example.206 
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Parameters.206 

Comments.206 
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:COMMunicate:SERial[n][:RECeive]:BITS.210 

Parameters.210 

Comments.210 

Example.210 

:COMMunicate:SERial[n][:RECeive]:BITS?.211 

Example.211 

:COMMunicate:SERial[n][:RECeive]:PACE[:PROTocol].211 

Parameters.211 

Comments.211 

Example.211 

:COMMunicate:SERial[n][:RECeive]:PACE[:PROTocol]?.212 

Example.212 
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:COMMunicate:SERia[[n][:RECeive]:PACE:THResho[d:STARt.212 

Parameters.212 

Comments.212 

Example.212 

:COMMunicate:SERial[n][:RECeive]:PACE:THReshold:STARt?.213 

Comments.213 

Example.213 

:COMMunicate:SERial[n][:RECeive]:PACE:THReshold:STOP.213 

Parameters.213 

Comments.213 

Example.214 

:COMMunicate:SERial[n][:RECeive]:PACE:THReshold:STOP?.214 

Comments.214 

Example.214 

:COMMunicate:SERial[n][:RECeive]:PARity.214 

Parameters.214 

Comments.215 

Example.216 

:COMMunieate:SERial[n][:RECeive]:PARity?.216 

Example.216 

:COMMunicate:SERial[n][:RECeive]:PARity:CHECk.216 

Parameters.216 

Comments.216 

Example.217 

:COMMunicate:SERial[n][:RECeive]:PARity:CHECk?.217 

Example.217 

:COMMunicate:SERial[n][:RECeive]:SBITs.217 

Parameters.217 

Comments.217 

Example.218 

:COMMunicate:SERial[n][:RECeive]:SBITs?.218 

Example.218 

:COMMunicate:SERial[n]:TRANsmit:AUTO.218 

Parameters.218 

Comments.219 

Example.219 

:COMMunicate:SERial[n]:TRANsmit:AUTO?.219 

Comments.219 

Example.219 

:COMMunicate:SERial[n]:TRANsmit:PACE[:PROTocol].219 

Parameters.219 

Comments.219 

Example.220 

:COMMunicate:SERial[n]:TRANsmit:PACE[:PROTocol]?.220 

Example.220 

:D/^E.220 

Parameters.220 

Comments.220 

Example.221 

:D/^E?.221 
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Example.221 

:ERRor?.221 

Comments.221 

Example.222 

TIME.222 

Parameters.222 

Comments.222 

Example.222 

TIME?.222 

Example.223 

:VERSion?.223 

Comments.223 

Example.223 

VXI Subsystem.224 

Subsystem Syntax.224 

:CONFigure:CTABle.226 

Parameters.226 

Comments.226 

Example.227 

:CONFigure:CTABle?.227 

Example.227 

:CONFigure:DCTable.228 

Parameters.228 

Comments.228 

Example.228 

:CONFigure:DCTable?.229 

Example.229 

:CONFigure:DLADdress?.229 

Comments.229 

Example.229 

:CONFigure:DLISt?.230 

Parameters.231 

Comments.231 

Example.231 

:CONFigure:DNUMber?.232 

Comments.232 

Example.232 

:CONFigure:ETABle.232 

Parameters.232 

Comments.232 

Example.233 

:CONFigure:ETABle?.233 

Example.233 

:CONFigure:HIERarchy?.233 

Comments.234 

:CONFigure:HIERarchy:ALL?.235 

Comments.235 

:CONFigure:INFormation?.235 
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Comments.236 

Example.236 

:CONFigure:INFormation:ALL?.237 

Comments.237 

:CONFigure:ITABle.237 

Parameters.237 

Comments.237 

Example.238 

:CONFigure:ITABle?.238 

Example.238 

:CONFigure:LADDress?.238 

Comments.238 

:CONFigure:LADDress:MEXTender?.239 

Comments.239 

:CONFigure:MEXTender:ECLTrg<n>.239 

Parameters.239 

Comments.239 

Example.240 

:CONFigure:MEXTender:INTerrupt<n>.240 

Parameters.240 

Comments.240 

Example.241 

:CONFigure:MEXTender:TTLTrg<n>.241 

Parameters.241 

Comments.241 

Example.242 

:CONFigure:MTABle.242 

Parameters.242 

Comments.243 

Example.243 

Example.243 

:CONFigure:NUMBer?.244 

Comments.244 

:CONFigure:NUMBer:MEXTender?.244 

Comments.244 

:QUERy?.244 

Parameters.244 

Comments.244 

Example.245 

:READ?.245 

Parameters.245 

Comments.245 

Example.246 

:RECeive[:MESSage]?.246 

Parameters.246 

Comments.246 

Example.247 

:REGister:READ?.247 

Parameters.247 

Comments.247 
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1 Keysight E1406A Command 
Module Overview 

About This Chapter 

This chapter contains WARNINGS and CAUTIONS, a functional and physical 
overview of the E1406A Command Module, and instructions on installing the 
eommand module in a mainframe. Chapter contents are as follows: 

Warnings and Cautions page 25 

Using Keysight VIC page 26 

Command Module Functional Description page 27 

Command Module Physical Description page 28 

llnstalling the Command Module in a Mainframe page 30 

Command Module Memory page 31 


Warnings and Cautions 


WARNING 


SHOCK HAZARD. Only qualified, service-trained personnel 
who are aware of the hazards involved should install, 
configure, or remove the multiplexer module. Disconnect 
all power sources from the mainframe, the terminal 
modules, and installed modules before installing or 
removing a module. 


CAUTION 


STATIC ELECTRICITY. Static electricity is a major cause of component 
failure. To prevent damage to the electrical components in the 
multiplexer, observe anti-static techniques whenever removing, 
configuring, and installing a module. The multiplexer is 
susceptible to static discharges. Do not install the multiplexer 
module without its metal shield attached. 


KEYSIGHT 

TECHNOLOGIES 
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Using Keysight VIC 

Our goal is to make installation of your C-size VXI system as easy as possible. To 
do so, Keysight VIC (Keysight VXI Installation Consultant) is provided with the 
Keysight El 406A Command Module. Keysight VIC is a Microsoft® Windows? 
program that helps you configure and install the Keysight E1406A Command 
Module - based on VXI systems. If your system contains an Keysight E1406A 
Command Module to be controlled by a computer external to the VXI mainframe, 
it is recommended you configure your system using Keysight VIC. 
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Command Module Functional Description 

The Keysight E1406A Command Module is the foundation of aVXIbus system 
(see Figure 1 -1). Though its role in a VXIbus system is largely transparent (for 
example, the user need not program its functions) it provides the following key 
functions: 

- Translates SCPI (Standard Commands for Programmable Instruments) 
commands for Keysight register-based instruments. 

- Provides the VXIbus slot 0 and resource manager capabilities. 

- Can drive the VXIbus TTLTRGO-7 and ECLTRGO-1 trigger lines. The module 
contains SMB connectors for placing an external trigger onto the selected 
line(s), and for routing an internal trigger to a device external to the 
mainframe. 

- Contains an internal clock that allows you to set and read the time and 
date. 

- Is the General Purpose Interface Bus (GPIB) to VXIbus interface. 



Figure 1 -1 VXIbus System 
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Command Module Physical Description 

The Keysight E1406A Command Module occupies one C-size mainframe slot. 
The faceplate has annunciators, clock and trigger connectors, interface ports, 
and extraction levers that are described below. 


Faceplate Annunciators 

There are four annunciators on the Keysight El 406A faceplate which show the 
following: 

Failed Shows that the command module has failed its power-on self-test or 
has stopped working at some point in time. 

SYSFAIl Shows that the SYSFAIL line on the VXIbus backplane is being 
asserted by the command module when it fails. 

Access Shows that the command module is accessing, or being accessed by 
the VXIbus backplane. 

Ready Shows the command module is in the VXIbus normal operation state. 



Figure 1-2 E1406A Command Module Faceplate 
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Keysight El406A Command Module Overview 


Faceplate CLKl 0 and Trigger Connectors 

There are four signal connectors on the Keysight El 406A faceplate which 
function as follows: 

Clk In This SMB connector allows an external 10 MHz clock to function as the 
system’s slot 0 CLKl 0 resource. This is a high impedance input with an input 
range from ± 40 mV to ± 42.5 V. 

Clk Out This SMB connector allows the internal slot 0 CLKIO resource to be 
routed to other VXIbus mainframes. This output is a TTL level output and drives 
50 Q. 

Trig In This SMB connector allows an external trigger signal (TTL levels) to be 
applied to the system on the trigger line selected (TTLTRG0-7/ECLTRG0-1). The 
input impedance is 5 kQ. 

Trig Out This SMB connector allows an internal trigger on the trigger line 
specified (TTLTRG0-7/ECLTRG0-1) to be applied to an external device. This 
output is a TTL level output and drives 50 Q. 

The GPIB and RS-232 Ports 

The GPIB port allows an GPIB cable to be connected from the Keysight E1406A 
to a computer, or to an external disk drive. The RS-232 port can be used as a 
user interface, or used for peripheral control if the Keysight E1406A contains 
Instrument BASIC (IBASIC). The RS-232 port is a 9-pin DTE connector. 
Supported terminals include: HP 700/92, HP 700/94, HP 700/22, HP 700/43, 
Wyse WY-30, DEC VT 100, and DEC VT220. 

The Run/Load Switch 

The run/load switch is located beneath the GPIB port. This switch lets you 
activate the loader instrument so that you can reprogram the Flash ROM or 
download device drivers to the Flash ROM. 


The Reset Button 

The reset button is located beneath the run/load switch. This button is used to 
reconfigure your VXIbus system and return It to the power-on state. 

Extraction Levers 

The extraction levers provide easy Insertion into and extraction from the C-size 
mainframe. 
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Installing the Command Module in a Mainframe 

Refer to Figure 1-3 to install the Keysight E1406A Command Module in a C-size 
mainframe. 




Set the extraction levers out. 


Slide the Agilent E1406A into any slot 
until the backplane connectors touch. 


Extraction 

Levers 



© Seat the command module into 
the mainframe by pushing in 
the extractbn levers. 


® 


Tighten the top and bottom screws to 
secure the command module to the 
mainframe. 


NOTE: The extraction levers will 
not seat the backplane connectors 
on older VXIbus mainframes. You 
must manually seat the connectors 
by pushing in the module until the 
module's front panel is flush with 
the front of the mainframe. The 
extraction levers may be used to 
guide or remove the command 
module. 


To remove the command module from the mainframe, 
reverse the procedure. 



Figure 1-3 Installing the Command Module in a VXIbus Mainframe 
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Command Module Memory 

The Keysight E1406A comes from the factory equipped with 512 KB of RAM and 
1.25 MB of Flash ROM. Keysight E1406A Option 010 provides 1.75 MB of Flash 
ROM and 1 MB of RAM. 

For applications which do not require shared RAM, the non-volatile RAM can be 
configured to a full 2 MB if the extra 512 KB of RAM and 512 KB of Flash ROM 
has been installed. 


Battery Backed Functions 

The Keysight El 406A clock and calendar functions, the user non-volatile RAM 
(NRAM), and the device driver RAM (DRAM) are backed up by a NiOad battery. 
For systems with 512 KB of memory this battery has a ten month lifetime and is 
fully recharged when the command module is in the mainframe and the power 
has been on for fifteen continuous hours. This battery has a five month lifetime 
for systems with 1 MB of RAM and 2.5 month lifetime for systems with 2 MB of 
RAM. 
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2 Configuring the Keysight El 406A 
Command Module 

About This Chapter 

One purpose of the Keysight El 406A is to provide 
the resource manager function required byVXIbus 
systems. This chapter describes the resource 
manager’s function and shows you howto modify 
the configuration process with user tables you 
download into non-volatile user RAM. All of these 
functions require the Flash ROMS Run/Load switch 
be set to "Run". 

The main sections of this chapter include: 

System Oonfiguration Sequence page 33 

Modules Oonfigured Statically and Dynamically page 34 

Setting VXI-MXI Oonfiguration page 40 

Setting Oommander/Servant Hierarchies page 53 

A24/A32 Address Mapping page 59 

interrupt Line Allocation page 69 

Starting System Operation page 77 

VXi SYSFAiL* Line page 77 

System Configuration Sequence 

As mentioned in the O-Size VXibus Systems Configuration Guide, the resource 
manager within the Keysight El 406A Command Module performs the following 
system configuration sequence when power is applied: 

- identify all statically and dynamically configured plug-in modules installed 
in the C-size mainframe. 

Set commander/servant hierarchies whereby one or more plug-in modules 
control other plug-in modules. 

Perform A24/A32 address mapping so modules requiring additional 
addressing can receive it. 

Allocate interrupt lines to manage communication between interrupt 
handler modules and interrupter modules. 

Start system operation. 
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Once the power-on sequence is completed and the system is started, the 
resource manager is no longer used. 

The following sections describe each step of the configuration sequence. 
Included are examples on how to change the sequence using configuration 
tables stored in non-volatile user RAM. 


NOTE 


Refer to the C-Size VXIbus Systems Configuration Guide for 
information on configuring the E1406A Command Module as the 
resource manager. 


Modules Configured Statically and Dynamically 

statically configured modules are plug-in modules whose logical addresses are 
set with logical address switches. Dynamically configured modules are plug-in 
modules whose logical addresses are programmed (set) by the resource 
manager. 


Identifying Statically Configured Modules 

Once all power-on self tests have completed, the resource manager identifies all 
statically configured modules. The resource manager retains information such as 
the module’s logical address, slot number, model number, manufacturer’s code, 
and so forth. 


Identifying Dynamically Configured Modules 

Once all statically configured modules have been located in a mainframe and 
none have a logical address of 255, the resource manager identifies all 
dynamically configured modules and assigns them logical addresses as follows. 

- The resource manager locates dynamically configured modules by 
scanning each mainframe slot. Refer to the plug-in module manual for 
additional information on setting up the module prior to its dynamic 
configuration. 

- Beginning with the lowest mainframe slot (excluding slot 0), the resource 
manager scans each slot via the module identification (MODID) bus until a 
dynamically configured module is located. The module is assigned a 
logical address that is the lowest available multiple of 8. 

- The resource manager continues scanning until the next dynamically 
configured module is located. The module is assigned a logical address 
that is the next available multiple of 8. The process continues until all 
dynamically configured devices have been assigned logical addresses. If all 
multiples of 8 are used, the dynamically configured module is assigned the 
first available address. 
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- Logical addresses used by statically configured devices will not be 
assigned to dynamically configured devices. 

- Dynamically configured devices will not be assigned logical address 255. 

- A set of address blocked dynamically configured devices will be assigned 
successive logical addresses beginning with the lowest available multiple 
of 8. 


User-Defined Dynamic Configuration 

If your system contains instruments comprised of multiple modules that must 
have successive logical addresses, then the modules must be statically 
configured using their logical address switches, or be dynamically configured 
with the user-defined dynamic configuration table. The dynamic configuration 
table covered in this section allows you to override the default configuration 
process by assigning logical addresses as you choose. 

The Dynamic Configuration Table 

User-defined dynamic configurations are specified with a dynamic configuration 
table created in the command module. The table is created as follows: 

1 Table space in the command module’s non-volatile user RAM is made 
available by allocating a segment of RAM with the command: 

DIAGnostic:NRAM:CREate <size> 

2 Reset the command module. NRAM is created during the boot-up process: 

DIAGnostic:BOOT:WARM 

3 The location (starting address) of the table in RAM is determined with the 
command: 

DIAGnostic:NRAM:ADDRess? 

4 Data is downloaded into the table with the command: 

DIAGnostic:Download <address>,<data> 

5 The table is linked to the appropriate algorithm in the command module 
processor with the command: 

VXI:CONFigure:DCTable <address> 
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Table Format 

The format of the dynamic configuration table is shown in Table 2-1. 


Table 2-1 Dynamic Configuration Table Format 


Valid Flag 

Number of 
Entries 



Slot Number 

SlotO Laddr 

Laddr 

Block Size 

Slot Number 

SlotO Laddr 

Laddr 

Block Size 

. 

. 

Slot Number 

SlotO Laddr 

Laddr 

Block Size 


The table parameters are: 

- Valid Flag (1/0) 1 (one) indicates the table is valid and the modules can be 
configured accordingly. 0 (zero) will cause an error message (Error 39). 
Valid Flag is part of the table header and is one byte. 

- Number of Entries (1 - 254) is the number of entries in the table. Number of 
Entries is part of the table header and is one byte. 

- Slot Number (1-12) is the mainframe slot the module to be assigned an 
address is installed in. Field is one byte. 

- Slot 0 Laddr is the logical address of the slot 0 device. This is 0 (zero) in 
mainframe #1 but will be different in any additional mainframes. Field is 
one byte. 

- Laddr (1 - 254) is the logical address to which the module in Slot Number is 
set. Field is one byte. 

- Block Sized-128) is the number of devices in an address block. When there 
is more than one device, Laddr specifies the logical address of the first 
device in the set. The remaining devices are assigned sequential logical 
addresses beginning with the next highest address. When there are 
multiple devices in a slot that are not address blocked, there must be an 
entry in the table for each device. Field is one byte. 

Determining the Table Size 

The dynamic configuration table has a two byte header and each of the four 
fields are one byte. The amount of RAM to allocate with 
DIAGnostic:NRAM:CREate is computed as: 

2 + 4(N) 
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where N is the number of modules to be configured. For example, to dynamically 
configure three modules based on logical addresses you have selected, the table 
size would be: 2 + 4(3) = 14 bytes. DIAGnostic:NRAM:CREate would be executed 
as: 


OUTPUT (a)E1406;"DIAG:NRAM:CRE 14" 


Data Format 

Data can be sent to the dynamic configuration table in any convenient format, as 
long as the binary data is preserved. This can be accomplished using 
DIAGnostic:PEEK? and DIAGnostic:POKE, by reading the data into a variable in 
the computer and then downloading the data to the table using the Arbitrary 
Block Program Data format, and so forth. In the following example, this is 
accomplished by reading the data into 16-bit integer variables in the computer 
and then downloading the data to the table using the ANSI/IEEE 488.2-1987 
Arbitrary Block Program Data format. More information on the Arbitrary Block 
Program format can be found in this manual and in the ANSI/IEEE 488.2-1987 
document. 


CAUTION 


When downloading data into the dynamic configuration table, 
DIAGnostic:DOWNload does not determine if the table is large 
enough to store the data. If the amount of data sent by 
DIAGnostic:DOWNload is greater than the (table) space allocated 
by DIAGnostic:NRAM:CREate, system errors will occur. You can 
recover from these errors by executing DIAGnostic:BOOT:COLD, or 
by pressing the "Ctrl-R" keys on an RS-232 terminal while cycling 
mainframe power. 


Example: Dynamically Configuring a Module 

The following program dynamically sets the logical address of the Keysight 
El 412A 61 ?2-Digit Multimeter in slot 6 to 32. The program notes each of the 
steps used to create and load the table. 

To dynamically configure the multimeter, its logical address must be set to 255 
using the logical address switches. 

10 lAssign an I/O path and allocate a variable to store dynamic 
configuration 

20 !data to be downloaded to the command module. 

30 ASSIGN @E1406 TO 70900jEOLCHR$(10)END 

40 INTEGER Dy_config(l:6) 

50 ! 

60 lAllocate a segment of non-volatile user RAM on the command 
70 Imodule to store the dynamic configuration table (1 module). 

80 OUTPUT @E1406j"DIAG:NRAM:CRE 6" 

90 ! 
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100 !Restart the system instrument to allocate the user RAM. Wait for the 

110 !restart to complete before continuing. 

120 OUTPUT @E1406j"DIAG:BOOT:WARM" 

130 ON TIMEOUT 7,.l GOTO Complete 
140 Complete:B=SPOLL(70900) 

150 OFF TIMEOUT 7 
160 ! 

170 !Return the starting address of the table in non-volatile user RAM. 

180 OUTPUT @E1406j"DIAG:NRAM:ADDR?" 

190 ENTER @E1406jA 

200 ! 

210 IDownload the following bytes: the table is validj one module is 
dynamically 

220 Iconfiguredj it^s installed in slot 6 , the logical address of the slot 0 
module 

230 !is 0j the logical address to be set is 32j and the block size is 1. 
240 DATA 257jlj6,0j32jl 

250 READ Dy_config(*) 

260 OUTPUT @E1406 USING "#j3(K)"j"DIAG:DOWN"jAj" ,#0" 

270 OUTPUT @E1406 USING "B"jDy_config(*) 

280 ! 

290 !Link the dynamic configuration table to the appropriate algorithm. 

300 OUTPUT @E1406;"VXI:CONF:DCT "jA 
310 ! 

320 IRestart the system instrument to set the user-defined configuration. 
330 OUTPUT @E1406j"DIAG:BOOT:WARM" 

340 END 
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Comments 

- Errors associated with dynamic configurations are: 

ERROR!: FAILED DEVICE 

This error occurs when a dynamically configured device at logical 
address 255 failed during its power-on sequence. 

ERROR 4: DC DEVICE ADDRESS BLOCK TOO BIG 

This error occurs when the block size specified in the table is greater 
than 127. 

ERROR 7: DC DEVICE MOVE FAILED 

This error occurs when a dynamically configured device was not set to 
the logical address specified, possibly due to a hardware failure on the 
module. The error also occurs when all devices in an address block did 
not move. 

ERROR 9: UNABLE TO MOVE DC DEVICE 

This error occurs when there are not enough successive logical 
addresses available for the specified block size, or if the logical address 
specified is already occupied by another static or dynamic module. 

ERROR 39: INVALID UDEF DC TABLE 

This error occurs when the user-defined dynamic configuration table is 
not true (valid flag does not equal 1). 

ERROR 40: INVALID UDEF DC TABLE DATA 

This error occurs when there are 0, or greater than 254 entries in the 
user-defined dynamic configuration table. 

- The logical addresses assigned by the dynamic configuration table are 
used by the system until DIAGnostic:BOOT:COLD or 
VXI:CONFigure:DCTable 0 is executed. 
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Setting VXI-MXI Configuration 

During configuration, if an MXI extender devioe is present the resource manager 
will attempt to assign logical addresses and memory aocording to the rules listed 
below. You oan override these rules by ereating a user-defined extender table. 
This table will be ignored if there are no MXI extender devices present. 

Logical Address Configuration 

The following rules and recommendations apply to assigning logical addresses. 
For a more detailed discussion of how to assign logioal addresses please refer to 
the Keysight El 482B VXI-MXI Bus Extender User’s Manual. 

- The window of a local extender must include the logical addresses of all 
remote extenders on its interconnect bus. 

- The downward window of a local extender cannot inolude any devices 
which are not its descendants, except its own address. It must include all 
devices on all of its own descendant busses. 

- A local extender should have a higher logical address than any statically or 
dynamically configured devices on its VMEbus (excluding other local 
extenders). 

- A local extender should have a lower logical address than any of its 
corresponding remote extenders and stand alone devices on its 
interconnect bus. 

- A remote extender should have the lowest logioal address on its own 
VMEbus. 

- The logical address of a remote extender can be lower than the address of 
its corresponding local extender on its interconnect bus. 

Default Logical Address Assignments 

The resource manager will attempt to assign logical addresses to dynamically 
configured devices according to the following rules: 

- The window for a local extender will be set outward to the minimum 
possible size to inolude all of the logical addresses found on all of its 
desoendant busses. This includes all stand alone devices and all remote 
extenders that are descendants of the loeal extender. 


NOTE 


The window for a local extender may or may not include the 
logical address of the local extender itself. 
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- The window for a remote extender will be set inward to the minimum 
possible size to include all of the devices on its VMEbus and all of its 
descendants. 


NOTE 


The window for a remote extender may or may not include the 
logical address of the remote extender itself. 


- A dynamically configured device will be assigned a logical address as 
follows: 

— Dynamically configured devices on a given VMEbus will be assigned 
logical addresses after all descendant busses of that VM Ebus have 
been configured. 

— Dynamically configured devices on a given VMEbus will be assigned 
addresses in the range defined by the statically configured device with 
the lowest logical address on that VMEbus and the maximum allowable 
logical address for that VMEbus. 

— Each dynamically configured device will be assigned an address that is 
a multiple of 8 within the allowable range for that VMEbus until all of 
these addresses have been used. 

— Any additional dynamically configured devices will be assigned the 
lowest available addresses within the allowable range for that VMEbus. 

A16/A24/A32 Address Window Configuration 

The following rules and recommendations apply to assigning A16/A24/A32 
logical addresses. Refer to the El 482B VXI-MXI Bus Extender User’s Manual for 
a more detailed discussion of how to assign logical addresses. 

- Systems with multiple VMEbus devices should be configured so that the 
VMEbus devices in mainframes whose remote extenders have the highest 
logical addresses should also have the highest logical addresses. 

- VMEbus devices should be configured to have the lowest addresses on 
their particular VMEbus. 
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Default A1 Address Window Assignments 

The resource manager will not attempt to perform any A16 address window 
configuration as a default. It will attempt to configure A24 and A32 memory 
according to the following rules: 

- A memory page is 1/256 of the total memory space. The minimum size of 
an A24 or A32 memory window is 2 pages and the maximum size of the 
window is 256 pages as defined in VXI-6 Specifications. For A24 memory a 
single page is 65,536 bytes and the minimum window size is 131,072 
bytes. For A32 memory a single page is 16,777,216 bytes and the 
minimum window is 33,554,432 bytes. 

- The base address of a memory window must be zero or an even multiple of 
the size of the window. 

- The window for a local extender will be set to the minimum possible size to 
include all of the memory addresses found on all of its descendants. 

- The window for a remote extender will be set to the minimum possible size 
to include all of the memory on its VMEbus and all of its descendants. 

- A VXIbus device will be assigned a memory location in the following 
manner: 

— VXIbus devices on a given VMEbus will be assigned memory locations 
after all descendant busses of the VMEbus have been configured. 

— VXIbus devices on a given VMEbus will be assigned memory locations 
in the range defined by the lowest and highest memory pages available 
for that bus. 

— The first available page for a VMEbus will be the first page that is higher 
than any reserved page on any of its ancestors. 

— VXIbus devices will be assigned the lowest memory locations available 
on the current bus. 

— VXIbus devices will be assigned locations according to memory size and 
logical address in that order. The device with the largest memory size 
on a given bus will be assigned an address first. For devices with the 
same size, the device with the lowest logical address will be assigned a 
memory location first. 

— If possible, no devices will be assigned to memory locations in the 
bottom or top 1/8 of the total memory (for example, in A24 memory 
addresses 00000016 - 20000016 or EOOOOOl 6 - FFFFFFl 6). 

- VMEbus reserved memory must be placed in locations that will not 
interfere with windows previously configured. The only way the resource 
manager can know the location(s) of VM Ebus memory is for you to provide 
this information in the user-defined memory table (see “ A24/A32 Address 
Mapping” for more details). 


42 


Keysight E1406A User Manual and SCPI Programing Guide 



Setting VXI-MXI Configuration 


Configuring the Keysight E1406A Command Module 


Interrupt Register Configuration 

The rules listed below will be used to assign the configuration of the INTX 
Interrupt Register during system start-up unless you override them with entries 
in the user-defined extender table. 

- The interrupt enable bits in the INTX Interrupt Register on every extender 
will be enabled for each VMEbus interrupt line that has a VXIbus handler 
assigned. 

- The interrupt enable bits in the INTX Interrupt Register on every extender 
will be disabled for each VMEbus interrupt line that has no VXIbus handler 
assigned. 

- For every VMEbus interrupt line that has a VXIbus interrupt handler 
assigned, the direction will be set on each extender such that an interrupt 
on that line will be routed towards the VMEbus backplane that contains 
the handler. 


TTL Trigger Register Configuration 

The TTL Trigger Register will be set to COCOl 6 (TTL Triggers disabled) for all 
remote and local extenders that support TTL Triggers. You may enable TTL 
Triggers and set the TTL Trigger directions with the extender table. 

ECL Trigger Register Configuration 

The ECL Trigger Register will be set to COCOl 6 (ECL Triggers disabled) for all 
remote and local extenders that support ECL Triggers. You can enable ECL 
Triggers and set the ECL Trigger directions with the extender table. 

Utility Register Configuration 

The default Utility Register configuration is shown in Table 2-2. Since the 
resource manager may have to reboot during the system configuration process 
(for example, to download a driver) the Utility Register is not a part of the 
extender table. This will help ensure that the SYSRESET signal will propagate 
throughout the system during a reboot so that all of the cards will receive a hard 
reset. 

If you wish to alter the contents of the Utility Register you can use 
DIAGnostic:POKE commands directly to the registers. Keep in mind that this may 
alter the default system reboot process. 
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Table 2-2 Utility Register Default Configuration 


1 Extender Type 

ACFIN 

ACFOUT 

SFIN 

SFOUT 

SPIN 

SPOUT 1 

Local Extender 

enabled 

enabled 

enabled 

enabled 

enabled 

enabled 


(1) 

(1) 

(1) 

(1) 

(1) 

(1) 

Remote 

enabled 

enabled 

enabled 

enabled 

enabled 

enabled 

Extender 

(1) 

(1) 

(1) 

(1) 

(1) 

(1) 


User-Defined Logical Address and Memory Windows 

In many systems that use extenders, the standard boot-up algorithms will not be 
suitable for your configuration. In such systems it will be necessary to 
unambiguously define your logical address and memory mapping forthe boot-up 
configuration routine. 

The User-Defined Extender Table 

You can define your own logical address and memory mapping in a system with 
extenders by using the user-defined extender table. This table is created as 
follows: 

1 Table space in the command module’s non-volatile user RAM is made 
available by allocating a segment of RAM with the command: 

DIAGnostic:NRAM:CREate <size> 

2 Reset the command module. NRAM is created during the boot-up process: 

DIAGnostic:BOOT:WARM 

3 The location (starting address) of the table in RAM is determined with the 

command: DIAGnostic:NRAM:ADDRess? 

4 Data is downloaded into the table with the command: 

DIAGnostic:DOWNload <address>, <data> 

5 The table is linked to the appropriate algorithm in the command module 
processor with the command: 

VXI:CONFigure:ETABle <address> 


44 


Keysight E1406A User Manual and SCPI Programing Guide 



Setting VXI-MXI Configuration 


Configuring the Keysight E1406A Command Module 


Table Format 

The user-defined extender table consists of a two byte header followed by the 
required number of extender records. The first byte of the header is a table Valid 
Flag (1 = valid) and the second byte specifies the number of records in the table. 

Table 2-3 Extender Table Format 

valid flag (011) 

# of records (N) 

extender record 1 

extender record 2 


extender record N 


Any single item in an extender record can be disabled so that the resource 
manager will perform the default configuration for the item. For example, to use 
the resource manager default algorithm for interrupt enable, set the appropriate 
field in the extender record (see Table 2-4) to 255. 


Keysight E1406A User Manual and SCPI Programing Guide 


45 



Configuring the Keysight E1406A Command Module 


Setting VXI-MXI Configuration 


Table 2-4 User-Defined Extender Table Record 


Field 

Description 

Format^ 

Range 

Field Disable 

Value 

1 

Logical Address (remote or local extender) 

inti 6 

1-255 

n/a 

2 

Logical Address Window Base 

inti 6 

0-254 

1 

255 

3 

Logical Address Window Size 

inti 6 

2-256 

n/a 

4 

A16 Memory Base Page 

inti 6 

0-254 

1 

255 

5 

A16 Memory Window Size (number of pages) 

inti 6 

2-256 

n/a 

6 

A24 Memory Base Page 

inti 6 

0-254 

1 

255 

7 

A24 Memory Window Size (number of pages) 

inti 6 

2-256 

n/a 

8 

A32 Memory Base Page 

inti 6 

0-254 

1 

255 

9 

A32 Memory Window Size (number of pages) 

inti 6 

2-256 

n/a 

10 

Interrupt Enable 

inti 6 

n/a 2 

255 

11 

TTL Trigger Enable 

inti 6 

n/a 3 

255 

12 

ECL Trigger Enable 

inti 6 

n/a 4 

255 


1 inti 6 is a 16-bit integer, or two bytes. 


1 The upper byte of this field (bits 15-8) is reserved. 

2 This is Mainframe Extender Register 1216. See the VXI-6 Specification or your 
mainframe extender manual for a definition of this register. Interrupts may not 
be supported by all mainframe extender cards. 

3 This is Mainframe Extender Register 1416. See the VXI-6 Specification or your 
mainframe extender manual for a definition of this register. TTL Triggers may 
not be supported by all mainframe extender cards. 

4 This is Mainframe Extender Register 1616. See the VXI-6 Specification or your 
mainframe extender manual for a definition of this register. ECL Triggers may 
not be supported by all mainframe extender cards. 
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Determining the Table Size 

The user-defined extender table has a one word header and each of the 12 fields 
is also one word. The amount of RAM allocated with DIAGnostic:NRAM:CREate is 
specified in bytes. Since one word is two bytes, the amount of RAM to allocate is 
computed as: 

2 + 24(N) 

where N is the number of modules to be configured. For example, to provide 
information for three extender devices, the table size would be: 

2 + 24(3) = 74 bytes 

DIAGnostic:NRAM:CREate would be executed as: 

OUTPUT ©El 406;"DIAG:NRAM:CRE 74" 

Data Format 

Data can be sent to the extender table in any convenient format, as long as the 
binary data is preserved. This can be accomplished using DIAGnostic:PEEK? and 
DIAGnostic:POKE, by reading the data into a variable in the computer and then 
downloading the data to the table using the Arbitrary Block Program Data 
format, and so forth. In the following example, this is accomplished by reading 
the data into 16 bit integer variables in the computer and then downloading the 
data to the table using the ANSI/IEEE 488.2-1987 Arbitrary Block Program Data 
format. More information on the Arbitrary Block Program format can be found in 
this manual and in the ANSI/IEEE 488.2-1987 document. 

The table header is sent as a single 16-bit word which must contain the Valid 
Flag and the number of modules involved. For a valid table, the header is 256 
plus the number of modules. For example, to indicate a valid table with seven 
entries, the header is 263 (256 + 7 = 263). 


CAUTION 


When downloading data into the user-defined extender table, 
DIAGnostic:DOWNload does not determine if the table is large 
enough to store the data. If the amount of data sent by 
DIAGnostic:DOWNload is greater than the table space allocated 
by DIAGnostic:NRAM:CREate, system errors will occur. You can 
recover from these errors by executing DIAG:BOOT:COLD, or by 
pressing the "Ctrl-R" keys on an RS-232 terminal while cycling 
mainframe power. 
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Example: User-Defined Extender Table 

This example shows a single interconnect bus with a local extender at logical 
address 63 in the root mainframe and a remote extender at logical address 64 in 
the secondary mainframe. 


258 

valid (upper byte) + 2 records (lower byte) 

63 

local extender logical address 

128 

logical address window base 

64 

logical address window size (128 to 191) 

255 

specify no A16 memory 

0 

A16 memory size (ignored) 

64 

A24 memory base page 

64 

A24 memory size (pages 64 to 127) 

0 

A32 memory base page 

128 

A32 memory size (pages 0 to 127) 

257 

interrupt line 1 enabled (IN) 

769 

TTL Triggers (TTL1 OUT.TTLOIN) 

-15936 

ECL Triggers (C1C016 = ECLO enabled OUT) 

64 

remote extender logical address 

128 

logical address window base 

64 

logical address window size (128 to 191) 

255 

specify no A16 memory 

0 

A16 memory size (ignored) 

64 

A24 memory base page 

64 

A24 memory size (pages 64 to 127) 

255 

specify no A32 memory 

0 

A32 memory size (ignored) 

256 

interrupt line 1 enabled (OUT) 

770 

TTL Triggers (TTL1 INJTLOOUT) 

-15935 

ECLTriggers(ECLOIN) 


The program on the next page downloads the table shown above into user 
non-volatile memory. The program notes each of the steps used to create and 
load the table. 
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10 lAssign an I/O path and allocate a variable to store MXI configuration 
20 !data to be downloaded to the command module. 

30 ASSIGN @E1406 TO 70900JEOL CHR$(10) END 
40 INTEGER MXI_config(l:25) 

50 ! 

60 lAllocate a segment of non-volatile user RAM on the command 
70 Imodule to store the user-defined MXI table (1 module). 

80 OUTPUT @E1406j"DIAG:NRAM:CRE 50" 

90 ! 

100 !Restart the system instrument to allocate the user RAM. Wait for the 

110 !restart to complete before continuing. 

120 OUTPUT @E1406j"DIAG:BOOT:WARM" 

130 ON TIMEOUT 7^.1 GOTO Complete 
140 Complete:B=SPOLL(70900) 

150 OFF TIMEOUT 7 
160 ! 

170 !Return the starting address of the table in non-volatile user RAM. 

180 OUTPUT @E1406j"DIAG:NRAM:ADDR?" 

190 ENTER @E1406jA 
200 ! 

210 !Download the required bytes. 

220 !See the user-defined extender table for the meaning of these bytes. 

230 DATA 258, 63, 128, 64, 255, 0, 64, 64, 0, 128, 257, 769, -15936, 64, 

128, 64, 255, 0, 64, 64, 255, 0, 256, 770, -15935 
240 READ MXI_config(*) 

250 OUTPUT @E1406 USING "#,3(K)"j"DIAG:DOWN "jAj" ,#0" 

260 OUTPUT @E1406 USING "W"jMXI_config(*) 

270 ! 

280 !Link the user-defined MXI table to the appropriate algorithm. 

290 OUTPUT @E1406j"VXI:CONF:ETAB "jA 
300 ! 

310 IRestart the system instrument to set the user-defined configuration. 
320 OUTPUT @E1406j"DIAG:BOOT:WARM" 

330 END 
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Comments 

- The following errors are associated with the extender table or indicate that 
you may need to create an extender table: 

ERROR 50: EXTENDER NOT SLOT 0 DEVICE 

This error occurs when a remote VXIbus extender in a remote 
mainframe is not in slot 0 of its mainframe. The resource manager 
expects all remote VXIbus extenders to be installed in slot 0 of their 
mainframe. 

ERROR 51: INVALID EXTENDER LADD WINDOW 

This error occurs when the configuration routine finds an invalid start 
address or size for an extender logical address window. You should 
reconfigure the logical addresses of the VXIbus devices or create a 
user-defined extender table for the system to override the default 
algorithm. 

ERROR 52: DEVICE OUTSIDE OF LADD WINDOW 

This error occurs when a device or devices were found outside the 
default maximum or outside the user-defined range for the extender. 
You should reconfigure the logical addresses of the VXIbus devices or 
create a new extender table for the system to override the default 
algorithm. 

ERROR 53: INVALID EXTENDER A24 WINDOW 

This error occurs when the configuration routine finds an invalid start 
address or size for an extender A24 address window. You should 
reconfigure the VMEbus memory devices or create a user-defined 
extender table to override the default algorithm. 

ERROR 54: DEVICE OUTSIDE OF A24 WINDOW 

This error occurs when an A24 memory device is located outside of the 
allowable logical address range of an MXIbus extender. You should 
reconfigure the VMEbus memory devices or create a user-defined 
extender table to override the default algorithm. 

ERROR 55: INVALID EXTENDER A32 WINDOW 

This error occurs when the resource manager finds an invalid start 
address or size for an extender A32 address window. You should 
reconfigure the VMEbus memory devices or create a user-defined 
extender table to override the default algorithm. 
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ERROR 56: DEVICE OUTSIDE OF A32 WINDOW 

This error occurs when an A32 memory device is located outside of the 
allowable logical address range of an MXIbus extender. You should 
reconfigure the VMEbus memory devices or create a user-defined 
extender table to override the default algorithm. 

ERROR 57: INVALID UDEF LADD WINDOW 

This error occurs when a user-defined logical address window violates 
the VXI-6 Specification (has an invalid base or size). You should redefine 
your extender table with correct values. 

ERROR 58: INVALID UDEF A16 WINDOW 

This error occurs when a user-defined A16 window violates the VXI-6 
Specification (has an invalid base or size). You should redefine your 
extender table with correct values. 

ERROR 59: INVALID UDEF A24 WINDOW 

This error occurs when a user-defined A24 window violates the VXI-6 
Specification (has an invalid base or size). You should redefine your 
extender table with correct values. 

ERROR 60: INVALID UDEF A32 WINDOW 

This error occurs when a user-defined A32 window violates the VXI-6 
Specification (has an invalid base or size). You should redefine your 
extender table with correct values. 

ERROR 61 INVALID UDEF EXT TABLE 

This error occurs when the valid flag is not set to 1 in the extender table. 
You should redefine your extender table with correct values. 

ERROR 62: INVALID UDEF EXT TABLE DATA 

This error occurs when there is an incorrect number of records for a 
user-defined extender table. You should make sure that the number of 
records shown in the header matches the number of records actually in 
the table. 

ERROR 63: UNSUPPORTED UDEF HL TRIGGER 

This error occurs when there is a user-defined extender table TTL 
Trigger entry for a MXIbus extender that does not support TTL Triggers. 

ERROR 64: UNSUPPORTED UDEF ECL TRIGGER 

This error occurs when there is a user-defined extender table ECL 
Trigger entry for a MXIbus extender that does not support ECL Triggers. 
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ERROR 66: INTX CARD NOT INSTALLED 

This error occurs when the INTX card is not installed on the VXI-MXI 
extender. You should make sure the INTX card is correctly installed and 
that it is functioning. 

- The system configuration assigned by the extended device table is used by 
the system until DIAGnostic:BOOT:COLD or VXI:CONFigure:ETABle 0 is 
executed. 
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Setting Commander/Servant Hierarchies 

In a VXIbus system, a commander is a plug-in module which controls other 
plug-in modules. “ Control” can be a commander such as the Keysight E1406A 
Command Module translating SCPI commands, and/or serving as the GPIB 
interface for (servant) modules within its servant area. 

During the configuration sequence, the resource manager assigns servant 
modules to a commander module based on the servants’ logical addresses and 
the commander’s servant area. The concept of the servant area is shown in 
Figure 2-1. The C-Size VXIbus Systems Configuration Guide shows how to set 
the command module’s servant area. 


Top Level Commander 
( E1406A ) 


Logical Address = 0 
Servant Area Switch - 255 
Servant Area = 1 - 255 




I 





_ 1 _ 

2nd Level 

Logical Address - t 

Device with 


Device with I 


Device with 
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Servant Area Switch = 40 
Servant Area = 2-40 

Logical Address 
of 48 

• • • 

Logical 
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Address 
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Logical Address 
of 48 


Register-Based 
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Device with 
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of 48 


Message-Based 


Regis ter-Base d 


E1406A F2-1 


Register-Based Register-Based 


Figure 2-1 Example of Commander/Servant Hierarchy 


Note the following regarding commander/servant relationships: 

- A commander’s servant area is its logical address + 1, through its logical 
address + its servant area switch setting. 

- If within a given commander’s servant area (Figure 2-1) there is another 
lower-level commander(s) (logical address 1), the given commander will 
control the lower-level commander. However, all modules within the 
servant area of the lower-level commander (logical addresses 2-41) will 
be controlled by the lower-level commander. 

- If there is a commander outside the servant area of the command 
module/resource manager, that commander becomes atop level 
commander. The resource manager will assign all modules within the 
commander’s servant area to that commander, or to that commander’s 
lower-level commanders. 
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- The command module will always be the commander for IBASIC even if 
IBASIC’s logical address (240) is outside the module’s servant area. There 
can be multiple IBASICs in the same system since each is a servant to its 
respective command module. Note that there are no VXIbus registers for 
IBASIC. 

User-Defined Commander/Servant Hierarchies 

In some systems you may need to assign a servant to a commander that is 
outside the commander’s servant area. In other systems, it may be necessary to 
change a module’s secondary GPIB address, or assign secondary addresses to 
modules whose logical addresses are not instrument identifiers. These tasks can 
be accomplished with the user-defined commander/servant hierarchy table 
described in this section. 


NOTE 


Register-based instrument drivers that support multiple card sets 
normally require that the cards in the set have sequential logical 
addresses. When instrument drivers support non-sequential 
logical addresses, instruments that consist of non-sequential card 
sets must be created using the user-defined commander/servant 
hierarchy table. There must be an entry in the table for every card 
in the instrument card set. 


The User-Defined Commander/Servant Hierarchy Table 

User-defined commander/servant hierarchies and secondary GPIB addresses are 
specified with a commander/servant hierarchy table created in the command 
module. The table is created as follows: 

1 Table space in the command module’s non-volatile user RAM is made 
available by allocating a segment of RAM with the command: 

DIAGnostic:NRAM:CREate <size> 

2 Reset the command module. NRAM is created during the boot-up process: 

DIAGnostic:BOOT:WARM 

3 The location (starting address) of the table in RAM is determined with the 
command: 

DIAGnostic:NRAM:ADDRess? 

4 Data is downloaded into the table with the command: 

DIAGnostic:DOWNload <address>, <data> 

5 The table is linked to the appropriate algorithm in the command module 
processor with the command: 

VXI:CONFigure:CTABle <address> 
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Table Format 

The format of the commander/servant hierarchy table is shown in Table 2-5. 

Table 2-5 Commander/Servant Hierarchy Table Format 

Valid Flag/ 

Number of 
Modules 


Laddr 

Cmdr Laddr 

Sec Addr 

Laddr 

Cmdr Laddr 

Sec Addr 

. 

Laddr 

Cmdr Laddr 

Sec Addr 


The table parameters are: 

- Valid Flag (1 /O) 1 indicates the table is valid and the modules should be 
configured accordingly. 0 (zero) will cause an error message (Error 38). 
Valid Flag is part of the table header and is represented by the upper eight 
bits of the header word. 

- Number of Modules (1 - 254) is the number of entries in the table. Number 
of Modules is part of the table header and is represented by the lower eight 
bits of the header word. 

- Laddr is the logical address of the module which is assigned a new 
commander or new secondary GPIB address. Field is one word. 

- Cmdr Laddr is the logical address of the commander to which the module 
specified by Laddr is assigned. If -1 is specified, the module is not assigned 
to a commander. Field is one word. 

- Sec Addr (1 - 30) is the secondary GPIB address assigned to the module 
specified by Laddr. If -1 is specified, the secondary address is assigned by 
default. Field is one word. 


Determining the Table Size 

The commander/servant hierarchy table has a one word header and three one 
word fields. The amount of RAM allocated with DIAGnostic:NRAM:CREate is 
specified in bytes. Since one word is two bytes, the amount of RAM to allocate is 
computed as: 

2 + 6(N) 

where N is the number of modules to be configured. For example, to assign three 
modules to a particular commander, the table size would be: 

2 + 6(3) = 20 bytes 
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DIAGnostic:NRAM:CREate would be executed as: 
OUTPUT @E1406;"DIAG:NRAM:CRE 20" 


Data Format 

Data can be sent to the commander/servant hierarchy table in any convenient 
format, as long as the binary data is preserved. This can be accomplished using 
DIAGnostic:PEEK? and DIAGnostic:POKE, by reading the data into a variable in 
the computer and then downloading the data to the table using the Arbitrary 
Block Program Data format, and so forth. In the following example, this is 
accomplished by reading the data into 16 bit integer variables in the computer 
and then downloading the data to the table using the ANSI/IEEE 488.2-1987 
Arbitrary Block Program Data format. More information on the Arbitrary Block 
Program format can be found in this manual and in the ANSI/IEEE 488.2-1987 
document. 

The table header is sent as a single 16-bit word which must contain the Valid 
Flag and the number of modules involved. For a valid table, the header is 256 
plus the number of modules. For example, to indicate a valid table with seven 
entries, the header is 263 (256 + 7 = 263). 


CAUTION 


When downloading data into the commander/servant hierarchy 
table, DIAGnostic:DOWNload does not determine if the table is 
large enough to store the data. If the amount of data sent by 
DIAGnosticiDOWNload is greater than the (table) space allocated 
by DIAGnostic:NRAM:CREate, system errors will occur. You can 
recover from these errors by executing DIAGnostic:BOOT:COLD, or 
by pressing the "Ctrl-R" keys on an RS-232 terminal while cycling 
mainframe power. 


Example: Assigning a Secondary GPIB Address 

The following program assigns secondary GPIB address 01 to the Keysight 
El 411B 5 1/2-Digit Multimeter at logical address 25. The program notes each of 
the steps used to create and load the table. 

10 lAssign an I/O path and allocate a variable to store commander/servant 

20 !hierarchy data to be downloaded to the command module. 

30 ASSIGN @E1406 TO 70900;EOL CHR$(10) END 
40 INTEGER Cs_hier(l:4) 

50 ! 

60 lAllocate a segment of non-volatile user RAM on the command module 
70 !to store the commander/servant hierarchy table. 

80 OUTPUT @E1406;"DIAG:NRAM:CRE 8" 

90 ! 

100 !Restart the system instrument to allocate the user RAM. Wait for the 


56 


Keysight E1406A User Manual and SCPI Programing Guide 





Setting Commander/Servant Hierarchies 


Configuring the Keysight E1406A Command Module 


110 !restart to complete before continuing. 

120 OUTPUT @E1406j"DIAG:BOOT" 

130 ON TIMEOUT 7^.1 GOTO Complete 
140 Complete:B=SPOLL(70900) 

150 OFF TIMEOUT 7 
160 ! 

170 !Return the starting address of the table in non-volatile user RAM. 

180 OUTPUT @E1406j"DIAG:NRAM:ADDR?" 

190 ENTER @E1406jA 
200 ! 

210 IDownload the following: the table is valid and one module is being 

220 lassigned a secondary addresSj the logical address of the module is 25j 

230 !its commander^s logical address is 0j the secondary address is 01. 

240 DATA 257,25,0^1 
250 READ Cs_hier(*) 

260 OUTPUT @E1406 USING "#,3(K)"j"DIAG:DOWN"jAj" ,#0" 

270 OUTPUT @E1406 USING "W"jCs_hier(*) 

280 ! 

290 !Link the commander/servant hierarchy table to the appropriate 
algorithm. 

300 OUTPUT @E1406j"VXI:CONF:CTAB"jA 
310 ! 

320 IRestart the system instrument to set the user-defined configuration. 
330 OUTPUT @E1406j"DIAG:BOOT" 

340 END 

Comments 

- The following errors are associated with the commander/servant hierarchy 
table: 

ERROR 12: INVALID UDEF COMMANDER LADD 

— This error occurs when the user-defined commander logical address 
specified in the table (Cmdr Laddr) is not a valid commander. Either the 
commander does not exist, or it is not a message-based device. 

ERROR 14: INVALID UDEF SECONDARY ADDRESS 

— This error occurs when the user-defined secondary address (Sec Addr) 
is invalid in the commander/servant hierarchy table. Valid secondary 
addresses are -1,1- 30. The error also occurs if the device to which the 
secondary address is assigned is outside the servant area of the 
command module. 

ERROR 15: DUPLICATE SECONDARY ADDRESS 

— This error occurs when the same secondary address is specified for 
more than one module in the commander/servant hierarchy table. 
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ERROR 18: INVALID COMMANDER LADD 

— This error occurs when the commander specified in the user-defined 
commander/servant hierarchy table is not a valid message-based 
commander, or the device does not exist. 

ERROR 37: INVALID UDEF CNFG TABLE 

— This error occurs when the user-defined commander/servant hierarchy 
table is not true (valid flag does not equal 1). 

ERROR 38: INVALID UDEF CNFG TABLE DATA 

— This error occurs when there are 0 or greater than 254 entries in the 
user-defined commander/servant hierarchy table. 

- The secondary GPIB addresses (and/or commanders) assigned by the 

commander/servant hierarchy table are used by the system until 

DIAGnostic:BOOT:COLD or VXI:CONFigure:CTABle 0 is executed. 
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A24/A32 Address Mapping 

During the configuration sequence, the resource manager reads each 


FFFFFF 

EOOOOO 

COOOOO 

BOOOOO 
520000 

500000 
400000 

200000 

000000 

Figure 2-2 A24/A32 Address Mapping Concept 

VXIbus device’s ID Register to determine if the device requires a block of A24 or 
A32 addresses. Figure 2-2 shows the address mapping concept. 

A24/A32 Address Allocation 

The resource manager allocates A24 and A32 addresses as follows: 

- The top and bottom 2 MB of A24 addresses are used by the command 
module for its own RAM and ROM. 

- VXIbus modules are allocated addresses from the bottom of the address 
space up. 


A24 

Address 

Space 
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- The order of address allocation is based on the number of addresses 
required (memory size) and the logical address. Modules with the largest 
amount of memory are allocated addresses first. Modules with the same 
amount of memory are allocated addresses beginning with the lowest 
logical address. 

- The top 2 MB of A24 addresses (used internally by the command module 
RAM) can be allocated. However, the command module cannot access 
those addresses on the other device. 

- An address allocation table can be used to reserve blocks of A24/A32 
addresses for VMEbus devices. This table is also used to assign addresses 
other than the default addresses assigned by the resource manager. 

- A24 address space is 16 MB and A32 address space is 4 GB. The command 
module does not have A32 address lines and cannot access A32 address 
space. However, it will allocate A32 address space for devices which can 
access it. A32 memory allocation is similar to A24 memory allocation. 

- A32 address space is 0000000016 through FFFFFFFFl 6. 

Allocating Address Space for VMEbus Devices 

The resource manager (command module) has no way to determine when 
VMEbus devices have been installed in the system. As a result, the resource 
manager allocates addresses to VXIbus A24/A32 devices rather than to VMEbus 
devices. 

There are two ways to prevent addresses intended for a VMEbus device from 
being assigned to VXIbus devices. The first method is described below. The 
second method uses an address allocation table to "reserve" a block of 
addresses. The table used for this is described in the section “ Reserving 
A24/A32 Address Space”. 

Allocating Address Space for VMEbus Devices: Method 1 

1 Configure and install all modules (except VMEbus devices) in the Keysight 
75000 Series C Mainframe. This process is described in the C-Size VXIbus 
Systems Configuration Guide. 

2 Turn on the mainframe and note section 6 of the resource manager’s 
configuration sequence (Figure 2-3). 

Given the starting (offset) A24 addresses assigned to the devices and the size 
of each device’s memory (converted to hexadecimal), the A24 addresses not 
allocated can be determined. For example, in Figure 2-3, the highest offset is 
24000016 with a size of 2000016 (131,072 bytes converted to hexadecimal). 
Thus, for this system, A24 addresses from 26000016 to DFFFFF16 are 
available to VMEbus devices. 
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NOTE 


In systems that include VXI-MXI extenders you should use a table 
to tell the resouree manager where your A24/A32 VMEbus memory 
is located. The resource manager cannot find VMEbus memory 
without this table. 
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Sequence Display 

Explanation 

1 Testing ROM 

Testing 512 KB RAM 

Passed 

Testing CPU 

CPU Self Test Passed 

Non-volatile Ram Contents Lost 

GPIB address: 09 

Talk/Listen 

command module ladd = 0 
command module servant area = 255 

The Keysight El 406A operating system performs a series of self-tests and clears 
its volatile RAM. The command module’s GPIB address, logical address, and 
servant area (based on the switch settings) are reported. 

2 Command Module VMEbus timeout — ENABLED. 

The resource manager identifies the status of the command module VMEbus 
timeout. This must be ENABLED for systems without VXlbus extenders (Keysight 
E1406A Gommand Module GPIB switch #5 = 0) 

3 Searching for static devices in mainframe 0 

SC device at ladd 0 in slot 0 

SC device at ladd 8 in slot ? 

SC device in ladd 16 in slot 8 

Searching for dynamic devices in mainframe 0 

DC device in slot 3 moved to ladd 24, block size = 1 

The resource manager identifies all statically configured modules, and then 
locates and configures all dynamically configurable modules. 

4 Searching for pseudo devices 

Pseudo devices are instruments such as IBASIC 

5 Configuring Commander/Servant hierarchy 
ladd = 0, cmdr ladd = -1 
ladd = 8, cmdr ladd = 0 
ladd = 16, cmdr ladd = 0 
ladd = 24, cmdr ladd = 0 
ladd = 32, cmdr ladd = 24 
ladd = 64, cmdr ladd = 24 

Validating Commander/Servant hierarchy 

Commander ladd 24 granted device ladd 32 

Commander ladd 24 granted device ladd 64 

The resource manager establishes the VXlbus system’s commander/servant 
hierarchies based on the commander’s servant area and the servant’s logical 
address. 

6 Mapping A24 Memory 

ladd 0, offset = 00200000H, size = 131,072 (bytes) 
ladd 24, offset = 00220000H, size = 131,072 (bytes) 
ladd 64, offset = 00240000H, size = 131,072 (bytes) 

Mapping A32 memory in mainframe 0 

The resource manager allocates A24 addresses to access the memory located on 
the modules at logical addresses 0,24, and 64. The offset is specified in 
hexadecimal and the size is specified in bytes. In this system, there are no A32 
devices. 

7 Configuring VME interrupts 

VME interrupt line 1 assigned to ladd 0, handler ID 1 

VME interrupt line 2 assigned to ladd 24, handler ID 1 

VME interrupt line 3 assigned to ladd 64, handler ID 1 

VME interrupt line 4 - no handler assigned 

VME interrupt line 5 - no handler assigned 

VME interrupt line 6 - no handler assigned 

VME interrupt line 7 - no handler assigned 

The resource manager allocates interrupt lines to itself and to the other interrupt 
handlers in the system. 

8 SYSTEM INSTALLED AT SECONDARY ADDR 0 

VOLTMTR INSTALLED AT SECONDARY ADDR 1 

SWITCH INSTALLED AT SECONDARY ADDR 2 

MBinstr INSTALLED AT SECONDARY ADDR 3 

SYSTEM instrument started 

BNO issued to ladd 24, BNO response = FFFE 

Opening GPIB access for message-based device at sec addr 03 

The resource manager identifies the secondary GPIB addresses used in the 
system, starts the system instrument (i.e., command module), issues the Begin 
Normal Operation (BNO) command to its direct message based servant, and 
opens GPIB access to the module at secondary GPIB address 03. 


Figure 2-3 Resource Manager Configuration Without Extenders 
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Sequence Display 

Explanation 

1 

Testing ROM 

Testing 512 KB RAM 

Passed 

Testing CPU 

CPU Self Test Passed 

Non-volatile Ram Contents Lost 

GPIB address: 09 

Talk/Listen 

command module ladd = 0 
command module servant area = 255 

The Keysight El 406A operating system performs a series of self-tests 
and clears its volatile RAM. The command module’s GPIB address, 
logical address, and servant area (based on the switch settings) are 
reported. 

T 

Command Module VMEbus timeout — DISABLED 

The resource manager identifies the status of the command module 

VMEbus timeout. This must be DISABLED for systems without VXIbus 
extenders (E1406A Command Module GPIB switch #5 = 0). 

~3 

Searching for static devices in mainframe 0 

SC device at ladd 0 in slot 0 

SC device at ladd 8 in slot ? 

SC device in ladd 16 in slot 8 

SC device at ladd 127 in slot 5 — VXIbus extender 

Searching for static devices on interconnect bus 127 

SC device at ladd 128 in slot 0 — VXIbus extender 

Searching for static devices in mainframe 128 

SC device at ladd 144 in slot 7 

Searching for dynamic devices in mainframe 128 

DC device in slot 3 moved to ladd 136, block size = 1 

VXIbus extender 128 Ladd window range: 128 to 159, INWARD 

VXIbus extender 127 Ladd window range: 128 to 159, OUTWARD 

Searching for dynamic devices in mainframe 0 

DC device in slot 3 moved to ladd 24, block size = 1 

The resource manager identifies all statically configured modules, and 
then locates and configures all dynamically configurable modules. 

T 

Searching for pseudo devices 

Pseudo devices are instruments such as IBASIC. 

T 

Configuring Commander/Servant hierarchy 
ladd = 0, cmdr ladd = -1 
ladd = 8, cmdr ladd = 0 
ladd = 16, cmdr ladd = 0 
ladd = 24, cmdr ladd = 0 
ladd = 136, cmdr ladd = 0 
ladd = 144, cmdr ladd = 0 

Validating Commander/Servant hierarchy 

Commander ladd 24 granted device ladd 32 

Commander ladd 24 granted device ladd 64 

The resource manager establishes the VXIbus system’s 
commander/servant hierarchies based on the commander’s servant area 
and the servant’s logical address. 

T 

Mapping A24 Memory 

Searching for A24 memory in mainframe 128 

VXIbus extender 128 A24 window range: 00000000 to OOFFFFFF, OUTWARD 
VXIbus extender 127 A24 window range: 00000000 to OOFFFFFF, INWARD 
Searching for A24 memory in mainframe 0 

ladd 0, offset = 00200000H, size = 131,072 (bytes) 

Mapping A32 memory 

Searching for A32 memory in mainframe 128 

VXIbus extender 128 A32 window range: 00000000 to FFFFFFFF, OUTWARD 
VXIbus extender 127 A32 window range: 00000000 to FFFFFFFF, INWARD 
Searching for A32 memory in mainframe 0 

The resource manager allocates A24 addresses to access the memory 
located on the modules at logical addresses 0, 24, and 64. The offset is 
specified in hexadecimal and the size is specified in bytes. In this system, 
there are no A32 devices. 

7 Configuring VME interrupts 

VME interrupt line 1 assigned to ladd 0, handler ID 1 

VME interrupt line 2 assigned to ladd 24, handler ID 1 

VME interrupt line 3 assigned to ladd 64, handler ID 1 

VME interrupt line 4 - no handler assigned 

VME interrupt line 5 - no handler assigned 

VME interrupt line 6 - no handler assigned 

VME interrupt line 7 - no handler assigned 

VXIbus e)ctender 128 interrupts: 1 -OUT 2-DIS 3-DIS 4-DIS 5-DIS 6-DIS 7-DIS 
VXIbus e)ctender 128 interrupts: 1-IN2-DIS 3-DIS 4-DIS 5-DIS 6-DIS 7-DIS 

The resource manager allocates interrupt lines to itself and to the other 
interrupt handlers in the system. 

8 

SYSTEM INSTALLED AT SECONDARY ADDR 0 

VOLTMTR INSTALLED AT SECONDARY ADDR 1 

SWITCH INSTALLED AT SECONDARY ADDR 2 

MBinstr INSTALLED AT SECONDARY ADDR 3 

SYSTEM instrument started 

BNO issued to ladd 24, BNO response = FFFE 

Opening GPIB access for message based device at sec addr 03 

The resource manager identifies the secondary GPIB addresses used in 
the system, starts the system instrument (i.e., command module), issues 
the Begin Normal Operation (BNO) command to its direct message based 
servant, and opens GPIB access to the module at secondary GPIB 
address 03. 


Figure 2-4 Resource Manager Configuration With Extenders 
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Reserving Address Space 

As previously mentioned, the resource manager cannot determine when VME 
devices have been installed in the system. To prevent the resource manager from 
allocating A24/A32 addresses intended for VME devices to VXIbus devices, the 
address allocation table is used. The A24/A32 address allocation table is also 
used to assign different addresses to VXIbus devices other than those (default) 
addresses assigned by the resource manager during power-on. 

The A24/A32 Address Allocation Table 

The A24/A32 address allocation table is created and stored in the command 
module as follows: 

1 Table space in the command module’s non-volatile user RAM is made 
available by allocating a segment of RAM with the command: 

DIAGnostic:NRAM:CREate <size> 

2 Reset the command module. NRAM is created during the boot-up process: 

DIAGnostic:BOOT:WARM 

3 The location (starting address) of the table in RAM is determined with the 
command: 

DIAGnostic:NRAM:ADDRess? 

4 Data is downloaded into the table with the command: 

DIAGnostic:DOWNload <address>, <data> 

5 The table is linked to the appropriate algorithm in the command module 
processor with the command: 

VXI:CONFigure:MTABle <address> 


Table Format 

The format of the A24/A32 address allocation table is shown in Table 2-6. 
Table 2-6 A24/A32 Address Allocation Table Format 


Table Format 

Memory Record Format 

Valid Flag/ Number of 

Lad dr 

Records 


Address Record #1 

Frame ID Addr space 

Address Record #2 

Base addr 

■ 

Memory size 


Address Record N 
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The table parameters are: 

- Valid Flag (0/1) 1 (one) indicates the table is valid and the addresses 
reserved accordingly. 0 (zero) will cause an error message (Error 43). Valid 
Flag is part of the table header and is represented by the upper eight bits 
of the header word. 

- Number of Records is the number of address records in the table. You 
must have one record for each VMEbus or VXIbus device for which memory 
is reserved. Number of Records is part of the table header and is 
represented by the lower eight bits of the header word. 

- Laddr is the logical address of the VXIbus device for which A24/A32 
addresses are reserved. -1 specifies a VMEbus device. Field is one word. 

- Addr space (24|32) is the address space being reserved. 24 specifies A24 
addresses are being reserved. 32 specifies A32 addresses are being 
reserved. Field is one word. 

- Frame ID (0-255) is the logical address of the slot 0 device for the 
mainframe containing the VMEbus memory block (8-bit byte). This field 
must be included. 

- Base addr (0 to 224-1/ 0 to 232-1) is the starting address (offset) of the 
A24 or A32 addresses to be reserved. Field is two words (4 bytes) and is 
specified in decimal. 

- Memory size (1 to 224-1/ 1 to 232-1) is the amount of memory for which 
addresses must be reserved. This field must be specified but is ignored if a 
VXIbus A24/A32 device is specified (Laddr). Field is two words (4 bytes) 
and is specified in decimal. 

Determining the Table Size 

The A24/A32 address allocation table has a one word header, the first two 
entries in the address record are one word each, and the second two entries are 
two words each. The amount of RAM allocated with DIAGnostic:NRAM:CREate is 
specified in bytes. Since one word is two bytes, the amount of RAM to allocate is 
computed as: 

2 + 12(N) 

where 2 is the two byte header, 12 is the number of bytes per address record 
(2+2+4+4), and N is the number of address records. For example, to reserve A24 
addresses for two VMEbus devices, the table size would be: 2 + 12(2) = 26 bytes. 
DIAGnostic:NRAM:CREate would be executed as: 

OUTPUT @E1406;"DIAG:NRAM:CRE 26" 
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Data Format 

Data can be sent to the A24/A32 address allocation table in any convenient 
format, as long as the binary data is preserved. This can be accomplished using 
DIAGnostic:PEEK? and DIAGnostic:POKE, by reading the data into a variable in 
the computer and then downloading the data to the table using the Arbitrary 
Block Program Data format, and so forth. In the next example, this is 
accomplished by reading the data into 16-bit integer variables in the computer 
and then downloading the data to the table using the ANSI/IEEE 488.2-1987 
Arbitrary Block Program Data format. More information on the Arbitrary Block 
Program format can be found in this manual and in the ANSI/IEEE 488.2-1987 
document. 

The Table Header 

The table header is sent as a single 16-bit word which must contain the Valid 
Flag and the number of address records. For a valid table, the header is 256 plus 
the number of records. For example, to indicate a valid table with two records, 
the header is 258 (256 + 2). 


CAUTION 


When downloading data into the A24/A32 address allocation 
table, DIAGnostic:DOWNload does not determine if the table is 
large enough to store the data. If the amount of data sent by 
DIAGnostic:DOWNload is greater than the (table) space allocated 
by DIAGnostic:NRAM:CREate, system errors will occur. You can 
recover from these errors by executing DIAGnostic:BOOT:COLD or 
by pressing the "Ctrl-R" keys on an RS-232 terminal while cycling 
mainframe power. 


Example: Reserving A24 Addresses for a VMEbus Device 

The following program reserves a block of A24 addresses for a VMEbus device. 
The program assumes the device has been configured with a starting A24 
address of 30000016 and a size of 8000016. 

Again, this procedure is used when you want to reserve a specific block of 
A24/A32 addresses for a VMEbus device, or when you want to assign addresses 
to a VXIbus device that are different from those assigned by the resource 
manager. 

10 lAssign I/O path and allocate variable to store A24/A32 memory 
20 lallocation data to be downloaded to the command module. 

30 ASSIGN @E1406 TO 70900JEOLCHR$(10)END 

40 INTEGER Mem_alloc(1:7) 

50 ! 

60 lAllocate a segment of non-volatile user RAM on the command 
70 Imodule to store the A24/A32 memory allocation table. 

80 OUTPUT @E1406j"DIAG:NRAM:CRE 14" 
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90 ! 

100 !Restart the system instrument to allocate the user RAM. Wait for the 

110 !restart to complete before continuing. 

120 OUTPUT @E1406j"DIAG:BOOT:WARM" 

130 ON TIMEOUT 7,.l GOTO Complete 
140 Complete:B=SPOLL(70900) 

150 OFF TIMEOUT 7 
160 ! 

170 !Return the starting address of the table in non-volatile user RAM. 

180 OUTPUT @E1406j"DIAG:NRAM:ADDR?" 

190 ENTER @E1406jA 
200 ! 

210 IDownload the following: the table is validj there is one memory 
220 Irecord: logical address is -1 (VME card)j A24 address space (24) 

230 !base address is 300000h (48^0)j and memory size is 80000h (8^0). 

240 !See Comments. 

250 DATA 257,-1,24,48,0,8,0 

260 READ Mem_alloc(*) 

270 OUTPUT @E1406 USING "#,3(K)"j"DIAG:DOWN"jAj" ,#0" 

280 OUTPUT @E1406 USING "W"jMem_alloc(*) 

290 ! 

300 !Link the A24/A32 memory allocation table to the appropriate algorithm. 
310 OUTPUT @E1406j"VXI:CONF:MTAB"jA 
320 ! 

330 IRestart the system instrument to set the user-defined configuration. 
340 OUTPUT @E1406j"DIAG:BOOT:WARM" 

350 END 


Comments 

- To download the base address and memory size (line 270) they must each 
be specified as two 16-bit words (line 250). This can be accomplished as 
follows: 


Memory Size: 30000016 = 

0030 

0000 


1 St word 

2nd word 


4810 

010 

Memory Size: 8000016 = 

0008 

0000 


1 St word 

2nd word 


810 

010 


- The following errors are associated with the A24/A32 address allocation 
table: 
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ERROR 8: INACCESSIBLE A24 MEMORY 

This error occurs when all or part of an A24 device overlaps the top 2 
MB or bottom 2 MB of the A24 address space. This space becomes 
inaccessible to the command module. 

ERROR 32: INACCESSIBLE A32 MEMORY 

This error occurs when all or part of an A32 device overlaps the top 500 
MB or bottom 500 MB of the A32 address space. 

ERROR 33: INVALID UDEF MEMORY BLOCK 

This error occurs when an invalid base address is specified, or when the 
size of the memory exceeds the A24 or A32 address space (given the 
base address specified). 

ERROR 34: UDEF MEMORY BLOCK UNAVAILABLE 

This error occurs when the memory block specified in the A24/A32 
address allocation table has already been assigned. Also, in a system 
with VXI-MXI extenders, A24/A32 window restrictions may force some 
addresses to be unavailable on a given VMEbus. 

ERROR 35: INVALID UDEF ADDRESS SPACE 

This error occurs when the address space (Addr space) specified in the 
table is A24 and an A32 device is installed, or vice versa. 

ERROR 36: DUPLICATE UDEF MEMORY LADD 

This error occurs when a logical address is specified more than once in 
the same A24/A32 address allocation table. This does not apply to 
VMEbus devices (address = -1). 

ERROR 43: INVALID UDEF MEM TABLE 

This error occurs when the user-defined A24/A32 address allocation 
table is not true (valid flag does not equal 1). 

ERROR 44: INVALID UDEF MEM TABLE DATA 

This error occurs when an invalid logical address is specified in the 
A24/A32 address allocation table. 


- The A24/A32 addresses reserved by the A24/A32 address allocation table 
are reserved within the system until DIAGnostic:BOOT:COLD or 
VXI:CONFigure:MTABle 0 is executed. 
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Interrupt Line Allocation 

In a VXIbus system, communication and coordination between a commander 
module and its servant module(s) is often achieved using the VXIbus backplane 
interrupt lines. During the configuration sequence, the resource manager assigns 
interrupt lines to programmable interrupt handler modules and interrupter 
modules. 

Both commanders and servants can be interrupt handlers and/or interrupters. 
The command module which is a programmable interrupt handler, is not an 
interrupter. Thus, in systems where the command module is a servant to another 
commander, it communicates with the commander through its Response and 
Data Low Registers (see the VXIbus System Specification). 

The assignment and use of the interrupt lines is described in Figure 2-5 and with 
the information which follows. 


Commander 
(e.g. E1406A) 


( 1 ) 



^ Modules which are not programmable interrupters must select the interrupt 
line using the jumpers on the module. 

MBS - Message Based Servant 
RBS - Register Based Servant 
PI - Programmable Interrupter 

(1) - Interrupt Line 1 

(2) - Interrupt Line 2 

Figure 2-4 Example of Interrupt Line Allocation 
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Note the following regarding interrupt line allocation: 

- There are seven VXIbus backplane interrupt lines. As the resource 
manager, the Keysight El 406A Command Module assigns itself interrupt 
line 1 (default). Additional interrupt lines (up to all seven) can be assigned 
to the command module using the interrupt line allocation table. Interrupt 
lines not assigned to programmable handlers remain unassigned. 

- Many Keysight modules have interrupt line 1 as their factory setting. Thus, 
they are available for immediate use with the Keysight El 406A. 

- Commander modules which are programmable interrupt handlers are 
assigned interrupt lines 2, 3, 4,...7; beginning with the commander with the 
lowest logical address. Only one interrupt line is assigned per interrupt 
handler. 

- Servant modules which are programmable interrupt handlers are also 
assigned interrupt lines, beginning with the servant with the lowest logical 
address. Only one interrupt line is assigned per interrupt handler. 

- Servant modules which are programmable interrupters are assigned the 
same interrupt line assigned to their commander. 

- For modules which are not programmable, the interrupt line is selected 
using jumpers on the modules. The interrupt line allocation table is used to 
tell the command module which line was selected. 

User-Defined Interrupt Line Allocation Table 

The interrupt line allocation table allows you to assign additional interrupt lines 
to a specific handler, reserve interrupt lines for non-programmable interrupt 
handlers and interrupters, and assign lines to VMEbus devices. 

The Interrupt Line Allocation Table 

User-defined interrupt line allocations are specified with an interrupt line table 
created in the command module. The table is created as follows: 

1 Table space in the command module’s non-volatile user RAM is made 
available by allocating a segment of RAM with the command: 

DIAGnostic:NRAM:CREate <size> 

2 Reset the command module. NRAM is created during the boot-up process: 

DIAGnostic:BOOT:WARM 

3 The location (starting address) of the table in RAM is determined with the 
command: 

DIAGnostic:NRAM:ADDRess? 

4 Data is downloaded into the table with the command: 

DIAGnostic:DOWNload <address>, <data> 

5 The table is linked to the appropriate algorithm in the command module 
processor with the command: 

VXI:CONFigure:ITABle <address> 
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Table Format 

The format of the interrupt line table is shown in Table 2-7. 
Table 2-7 Interrupt Line Allocation Table Format 


Table Format 

Data Record Format 

Valid Flag/ 

Intr Line 

Number of Records 


Data Record #1 

Handler Laddr 

Data Record #2 

Number of Interrupters 

• 

lntr#l Laddr 

• 

Intr #2 Laddr 

Data Record #7 

Intr M Laddr 


The table parameters are: 

- Valid Flag (1/0) 1 (one) indicates the table is valid and the modules should 
be configured accordingly. 0 (zero) will cause an error message (Error 41). 
Valid Flag is part of the table header and is represented by the upper eight 
bits of the header word. 

- Number of Records (1 - 7) is the number of data records in the table. A data 
record is required for each interrupt line assigned. Number of Records is 
part of the table header and is represented by the lower eight bits of the 
header word. 

- Intr Line (1 - 7) is the interrupt line to be assigned to the programmable 
interrupt handler or interrupter, or the line reserved for a 
non-programmable interrupter/handler or VMEbus device. Field is one 
word. 

- Handler Laddr is the logical address of the programmable handler which will 
handle interrupts on the line specified by Intr Line. If -1 is specified, the line 
is reserved and no handler is assigned. The field is one word. 

- Number of Interrupters is the number of programmable interrupters on the 
interrupt line specified by Intr Line. If 0 is specified, there are no 
programmable interrupters. This reserves the line for a non-programmable 
interrupter. The field is one word. 
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- Intr Laddr is the logical address of the programmable interrupter on the 
interrupt line specified. The logical address of each programmable 
interrupter on the line must be specified. Programmable interrupters can 
be assigned to interrupt lines with no handler. This allows a programmable 
interrupter to have a non-programmable interrupt handler handle its 
interrupts. If Number of Interrupters is 0, Intr Laddr is not specified. 

Determining the Table Size 

The interrupt line allocation table has a one word header and each data record 
contains three words, plus one word for each programmable interrupter logical 
address specified. The amount of RAM allocated with DIAGnostic:NRAM:CREate 
is specified in bytes. Since one word is two bytes, the amount of RAM to allocate 
is computed as: 


N 

2 + 6(W) + 2^M 
0 


where 2 is the two byte header, 6 is the number of bytes/data record, N is the 
number of data records (for example, interrupt lines) and M is the number of 
programmable interrupters per data record. For example, to create a table for the 
following: 

- one interrupt handler 

- two interrupt lines 

- one interrupter on one line, three interrupters on second line the table size 

would be: 

2 + 6(2) + 2(4) = 22 bytes 

(2 records) (4 interrupters) 

DIAGnostic:NRAM:CREate would be executed as: 

OUTPUT @E1406;"DIAG:NRAM:CRE 22" 


NOTE 


When assigning an additional interrupt line to an interrupt 
handler, you must specify each line. Otherwise, the table will 
overwrite the line currently assigned, giving the handler only one 
line. For example, if the resource manager assigns interrupt line 2 
to a handler and you want to also assign line 3 to the handler, 
lines 2 and 3 must be specified in the table. See “ Example: 
Assigning an Interrupt Line”. 
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Data Format 

Data can be sent to the interrupt line allocation table in any convenient format, 
as long as the binary data is preserved. This can be accomplished using 
DIAGnostic:PEEK? and DIAGnostic:POKE, by reading the data into a variable in 
the computer and then downloading the data to the table using the Arbitrary 
Block Program Data format, and so forth. In the following example, this is 
accomplished by reading the data into 16 bit integer variables in the computer 
and then downloading the data to the table using the ANSI/IEEE 488.2-1987 
Arbitrary Block Program Data format. More information on the Arbitrary Block 
Program format can be found in this manual and in the ANSI/IEEE 488.2-1987 
document. 

The table header is sent as a single 16-bit word which must contain the Valid 
Flag and the number of data records. For a valid table, the header is 256 plus the 
number of data records. For example, to indicate a valid table with one data 
record, the header is 257 (256 + 1 = 257). 


CAUTION 


When downloading data into the interrupt line allocation table, 
DIAGnostic:DOWNload does not determine if the table is large 
enough to store the data. If the amount of data sent by 
DIAGnostic:DOWNload is greater than the (table) space allocated 
by DIAGnostic:NRAM:CREate, system errors will occur. You can 
recover from these errors by executing DIAGnostic:BOOT:COLD, or 
by pressing the "Ctrl-R" keys on an RS-232 terminal while cycling 
mainframe power. 


Example: Assigning an Interrupt Line 

The following example shows how an additional interrupt line is assigned to a 
programmable interrupt handler and reserved for a non-programmable 
interrupter (Figure 2-6). 
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Interrupt Line Allocation 



Logical Address = 0 
Servant Area = 1-255 



1 _ 

_ 1 

2 

E1411B 

Multimeter 


Logical Address = 64 
Servant Pointer - 32 
Servant Area = 65 96 
Assigned VXI Interrupt Line = 2 


Logical Address 80 
VXI Interrupt Jumper = 3 


Figure 2-5 Assigning an Additional Interrupt Line 


The program assumes that a VXIbus system contains an Keysight El 411 B 

51 ?2-Digit Multimeter that is a servant to a second Keysight El 406A Command 

Module at logical address 64. Since the command module is the only other 
commander and is a programmable interrupt handler, it is assigned interrupt line 
2 by the resource manager. The El 411 B, however, has its interrupt jumper setter 
line 3. For the multimeter to communicate with the command module, the 
command module must also be assigned to handle interrupt line 3. 

10 lAssign an I/O path and allocate a variable to store interrupt line 
20 Idata to be downloaded to the command module. 

30 ASSIGN @E1406 TO 70900jEOLCHR$(10)END 

40 INTEGER Intr_line(l:7) 

50 ! 

60 lAllocate a segment of non-volatile user RAM on the command module 

70 !to store the interrupt line table (2 data recordSj no interrupters). 

80 OUTPUT @E1406j"DIAG:NRAM:CRE 14" 

90 ! 

100 !Restart the system instrument to define the user RAM. Wait for the 

110 !restart to complete before continuing. 

120 OUTPUT @E1406j"DIAG:BOOT" 

130 ON TIMEOUT 7,.l GOTO Complete 
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140 Complete:B=SPOLL(70900) 

150 OFF TIMEOUT 7 
160 ! 

170 !Return the starting address of the non-volatile user RAM. 

180 OUTPUT @E1406j"DIAG:NRAM:ADDR?" 

190 ENTER @E1406jA 

200 ! 

210 IDownload the following: the table is valid - there are two data 
records. 

220 linterrupt line 3 (and line 2) is assigned to the handler at logical 
address 64. 

230 IThere are no programmable interrupters on either line. 

240 DATA 258,2,64,0 

250 DATA 3,64,0 

260 READ Intr_line(*) 

270 OUTPUT @E1406 USING "#,3(K)"DIAG:DOWN"jAj" ,#0" 

280 OUTPUT @E1406 USING "W"jIntr_line(*) 

290 ! 

300 ILink the interrupt line table to the appropriate algorithm. 

310 OUTPUT @E1406j"VXI:CONF:ITAB"jA 
320 ! 

330 IRestart the system instrument to set the user-defined configuration. 

340 OUTPUT @E1406j"DIAG:BOOT" 

350 END 

Comments 

- Although interrupt line 2 was assigned to the command module at logical 
address 64 by the resource manager, the line must be "re-assigned" when 
line 3 is assigned. Otherwise, line 3 will be assigned in place of line 2. 

- The interrupt lines assigned by the interrupt line table are used by the 
system until DIAGnostic:BOOT:COLD is executed. 

- When using multiple command modules, GPIB cables must be connected 
from the slot 0 command module, to each command module in the 
system. 

- In this program, the command module at logical address 64 has a primary 
GPIB address of 08. It has a servant pointer setting of 32, thus its servant 
area is from logical address 65 to logical address 96. If the Keysight 

El 411 B multimeter has a logical address of 80, its secondary GPIB address 
is 10. Thus, when programming this multimeter, its GPIB address is: 

GUTPUT 70810;".... 

When programming this command module, its GPIB address is: 

GUTPUT 70800;"... 

- The following errors are associated with the Interrupt Line Allocation table: 
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ERROR 24: INTERRUPT LINE UNAVAILABLE 

This error occurs when an interrupt line assigned by the user-defined 
interrupt line allocation table is not available. Either the line has already 
been assigned or has been reserved. This error also occurs if the line 
being assigned to an interrupter is not handled by the interrupter’s 
commander. 

ERROR 25: INVALID UDEF HANDLER 

This error occurs when the logical address specified in the user-defined 
interrupt line allocation table for the interrupt handler (Handler Laddr) 
is a device that is not a valid interrupt handler. 

ERROR 26: INVALID UDEF INTERRUPTER 

This error occurs when the logical address specified in the user-defined 
interrupt line allocation table for the interrupter (Intr # Laddr) is a 
device that is not a valid interrupter. 

ERROR 41: INVALID UDEF INTR TABLE 

This error occurs when the user-defined interrupt line allocation table is 
not true (valid flag does not equal 1). 

ERROR 42: INVALID UDEF INTR TABLE DATA 

This error occurs when the user-defined interrupt line allocation table 
has invalid data; the number of records and/or the interrupt line 
specified is less than 1 or greater than 7, or there is an invalid interrupt 
handler and/or interrupter logical address (valid addresses are 0 to 
255). 

- The interrupts assigned by the interrupt line allocation table are used by 
the system until DIAGnostic:BOOT:COLD or VXI:CONFigure:ITABle 0 is 
executed. 
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Starting System Operation 

The resource manager completes the configuration sequence by issuing the 
"Begin Normal Operation" (BNO) command to all top level commanders and to 
each of its direct message based servants. BNO is not sent to register based 
modules. The module receiving BNO responds by writing its status 

to the Data Low Register which is read by the resource manager. More 
information on BNO and on the Data Low Register can be found in the VXIbus 
System Specification. 

If the command module is in a system where it is not the resource manager, it 
sends BNO to each of its message based servants once it receives BNO from its 
commander. 


VXI SYSFAIL* Line 


One of the signals on the VXI backplane is SYSFAIL*. This signal is intended to 
indicate that some VXI module in the system has failed. During power-on 

or rebooting the Keysight E1406A, VXI modules may briefly generate the 
SYSFAIL* signal. VXI modules that fail to operate may continue to generate 
SYSFAIL* after the power-on period as an indication of the failure. Similarly, 
modules that fail during operation of the system may also generate SYSFAIL* 
when the failure occurs. 

If the Keysight E1406A Command Module detects the SYSFAIL* after the 
power-on period, it will automatically reboot. When this occurs, the command 
module will not enable communication with any of the VXI modules in the 
system. This is because the Keysight E1406A cannot determine which VXI 
module has failed. Also, if IBASIC is installed, it will be disabled. Only the System 
instrument will be enabled. This behavior is intended to guarantee that you will 
recognize that a failure has occurred. 

If this situation occurs, the SYSTem:ERRor? query will return the 

Error +2129, "Warning, Sysfail detected". 

To restore normal operation of the Keysight El 406A Command Module, you must 
determine which VXI module has failed and remove it from the system. After 
removing the failed module and cycling power on your VXI mainframe, your 
Keysight E1406A Command Module will work normally. 
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3 Using the Display Terminal 
Interface 

About This Chapter 

This chapter shows you how to use the El 406A 
Command Module’s display terminal interface to 
operate instruments in a C-Size mainframe when 
the Flash ROMS Run/Load switch is set to its 
"Run" position. The instruments (including the 
System instrument) are disabled when the Flash 
ROMS Run/Load switch is in the "Load" position. 



In this position, a special Loader instrument is present, and will let you download 
drivers or a new operating system to Flash ROM. The terminal interface uses the 
built-in RS-232 port and/or the optional Keysight El 324A RS-232C/422 
Terminal Interface for Command Modules to provide a front panel for C-size 
VXIbus systems. 

The main sections of this chapter include: 


Terminal Interface Features page 80 

Using Display Terminal Menus page 80 

Executing Commands page 96 

General Key Descriptions page 97 

Using Supported Terminals page 99 

Using Other Terminals page 103 

In Case of Difficulty page 107 

System Instrument/Switchbox Menus page 108 


NOTE 


This chapter discusses using the display terminal interface. It 
assumes you have already connected your terminal and 
configured it to communicate with the command module. For 
information on connecting and configuring your terminal, see the 
C-Size VXIbus Systems Configuration Guide. 



KEYSIGHT 

TECHNOLOGIES 
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Terminal Interface Features 


Figure 3-1 shows a typical terminal interface display with its function labels 
across the bottom of the screen. The first five function keys (fl through f5) select 
instrument menu choices. Function keys f6 through f8 provide menu control and 
access to utility functions. The tutorials in this chapter show how to use most of 
the menu control and utility function keys. See “ General Key Descriptions” for a 
complete description of each of these key functions. 

Notes: 1. Example screens are from the AdvanceLink terminal emulator. 

2. Later screen examples are shown compressed (only 4 lines high) and may 
show only part of the screen width. 


UOLTMTP 8: 


Instrument 




+9.900000E+037 U ' 
+2.119064E-001 U 
+5.274897E-001 U 
+5.B9B074E-001 U 
+4.B23773E-001 U 
+6.44&466E-001 U 

neas:voIt? 
+9.900000E+037 U 
neas: i>o It? 
+9.900000E+037 U 
neas:uoIt? 
+1.9B312BE-003 U 
neas:uoIt? 
+2.047310E+000 U 
abcdef 

-113,"Undefined header" 
neas ‘ volt:ac? 
+3.621697E-003 U ■ 
neas:fres?_ . 


Text Output 



Command Entry Line 
Prompt Line 
Input Line 




22 11 Bl 


UTILS 




J 


Figure 3-1 Typical Terminal Interface Display 


Using Display Terminal Menus 

A System instrument menu and a variety of other instrument menus (depending 
on the instruments in the command module servant area) are available from the 
terminal interface. These menus incorporate the most used functions but do not 
provide access to the complete functionality of an instrument. If a particular 
function is not available from a menu, you can type the corresponding common 
command or SCPI command string and execute it from the terminal interface. 
See “Executing Commands” for more information. 
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Using the DispiayTerminai Interface 


When you select an instrument, you are assigning the terminal interface to that 
instrument. This means that any menu operations, commands executed or 
recalled, errors displayed, and so forth pertain only to that instrument. Terminal 
interface operation of an instrument is independent from other instruments and 
independent from the remote operation of the instrument. To operate another 
instrument from the terminal interface, you must select that instrument. 


How Instruments Appear in the Menu 

Instruments in the terminal interface menu are register-based devices which are 
in the servant area of the command module. Message-based devices. 


or register-based devices outside the command module’s servant area, do not 
appear in the menu. 


Message-based instruments, which do not appear in instrument 
menus, can be programmed using the SYSTEM instrument menu. 
See “Using the System Instrument Menu”. 



Multiple Command Modules 

In systems with multiple command modules, the instruments in the menu 
depend on the command module whose RS-232 port is connected to the 
terminal. To change menus (command modules): 

1 Move the RS-232 cable to the desired command module. 

2 Press the “Ctrl-D” keys on an RS-232 terminal to guarantee that the display 
terminal interface is in control of the terminal. 

3 Type: 

ST (followed by Return) for auto-identification of the terminal. 


or 


ST HP (followed by Return) for HP terminals - 700/94, 700/92, 26xx, 23xx 


or 


STHP70043 (followed by Return) for the HP 700/43 terminal 


or 


STVT100 (followed by Return) for VTIOO emulators 


or 


STVT220 (followed by Return) for VT220 emulators 


or 


ST WYSE30 (followed by Return) for WY-30 emulators 
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or 

ST WYSE50 (followed by Return) for WY-50 emulators 

This changes the menu to correspond to the instruments in the servant area of 
the new command module. 


Display Terminal Menu Tutorial 

Following the power-on sequence or a system reset, the screen shows the Select 
an instrument menu (see Figure 3-2). This menu allows you to select one of the 
instruments listed. 


Select an instrument. 




SWITCH a IBASIC 


21 


Note: Typical instruments are shown. Actual choices depend on installed instruments. 

Figure 3-2 "Select an Instrument" Menu 


Figure 3-2 shows the Select an Instrument menu when the Flash ROMS 
Run/Load switch on the front of the Keysight El 406A Command Module is set to 
"Run". If this switch is in the "Load" position, the SYSTEM instrument entry will 
be replaced by LOADER and the rest of the instruments will disappear from the 
menu. 

The menu select and menu control function keys (usually labeled fl - f8 on their 
key caps) are defined by eight function labels located across the bottom of the 
terminal screen. Once you learn how these keys operate, using the menus is easy 
(key labels are shown in bold text in this chapter): 

To select a displayed menu choice, press the function key (fl - f5) which 
corresponds to the function key label. 

- When there are more than five menu choices, function key f6 becomes 
labeled MORE. Press MORE to display the next group of choices. By 
repeatedly pressing MORE you can display all groups of choices. After you 
have displayed all groups of choices, pressing MORE again returns to the 
first group of choices. 

- Whenever the screen is requesting information (input prompt) such as 
Enter the device’s logical address, just type the information and press 
Return (may be Enter on a terminal emulator). 

If you pressed the wrong menu key and do not want to enter the requested 
information, you can escape the input prompt and stay at the same menu 
level by pressing ESO or PR\/_MENU. 
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Using the Display Terminal Interface 


If you make an incorrect entry in response to an input prompt, the bottom 
line of the Text Output Area will show an error message. When this 
happens, just select that menu choice again (fl - f5 keys), re-type the 
correct information, and press Return. 

- Press PRV_MENU or ESC to return to the previous menu within an 
instrument menu or escape from an input prompt. Press SEL_INST to 
return to the Select an Instrument menu (see next item). Note that when 
you leave an instrument and return later, you return to the same menu 
location you were at when you left. Any information below the Text Output 
Area will also be redisplayed when you return. 

- In addition to the Instrument menu keys, CLRJNST, RST_INST and 
SELJNST are helpful when operating instruments. These and other utility 
keys are accessed by pressing the UTILS key (see Figure 3-3). Refer to 
“Geral Key Descriptions” for information on the RCL_.... keys in this menu. 

— CLRJNST clears the instrument’s terminal interface input and output 
buffers (remote buffers are not cleared) and returns to the top level of 
the instrument menu. Press CLR_INST whenever an instrument is busy, 
is not responding to terminal interface control, or to abort a command 
being entered from the terminal interface. 

— RSTJNST clears all terminal interface and remote input and output 
buffers and resets the instrument. 

— SELJNST returns you to the Select an Instrument menu. SEL_INST is the 
key under the UTILS key. You can easily return to the Select an 
Instrument menu by pressing f8 twice. 



Figure 3-3 Accessing the Utility 


Keysight E1406A User Manual and SCPI Programing Guide 


83 




Using the Display Terminal Interface 


Using Display Terminal Menus 


Using the System Instrument Menu 

The System instrument menu allows you to: 

- Read the command module GPIB address 

- Display logical address and instrument information 

- Configure the RS-232 port 

- Program message-based devices 

- Set the system clock and calendar 

- Reset the system 

The menus on the following pages demonstrate how to do each of the above. 


Select an instrument. 




SUITCH a IBASIC 


SVSTEM 0: 




HP-IB? a RS-232 a DEBUG 


Typical GPIB address: +9 
SCPI command used: 
SYST:COMM:GPIB:ADDR? 


Figure3-4 Reading the Command Module GPIB Address 
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r 





SVSTEM_0: 

♦0,*8,*32,*240 



Logical address of selected device 


Instrument name 




sysiBn_0: 

♦8, *0, *4095, +65344,-1. +0, REG. A16 . #800000000, #800000000. READV, , "UOLTMTR 

INSTALLED AT SECONDARV ADDR 1" < - 


DEVICE 


1 5l 


GPIB secondary address 




J 


Figure 3-5 Displaying Logical Addresses and System Instrument Information 
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/-\ 



Note: Configuration of the E1406A RS-232 port is covered in the C-Ste V'XIbus Systems Configuration Guide. 

\ _____ / 


Figure 3-6 Configuring the Command Module RS-232 Port 
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r -\ 



SCPI command used: VXI:SEND <logical_address>, ''<nisg_string>'\,<end_ftag>] 

V_/ 

Figure 3-7 Programming Message-Based Devices 
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Select an instrunent. 


i^^M|z2S25nE3i|3| 


SWITCH a IBHSIC 


SVSTEN 0: 




RS-232 21 DEBUG 


53 1 5 


UTILS 


I 


SVSTEM 0: 




SySTEM_0: 

Enter tine (hhjnn,ss) 

T| 


SCPI command used: 

SYST:TIME <hoiir>, <minute><second> 


SVSTEM 0: 


RESET 


SVSTEM 0: 


SVSTEM_0: 

Enter date (i|y^,nn,dd) 


SCPI command used: 

SYST'.DATE <year>, <month>,<day> 


Figure 3-8 Setting the System Clock and Calendar 
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r 





Note: The RESET selection in this menu is equivalent to executing DIAG:BOOT, which has the same effect as 
cyding the mainframe power. Pressing RST_INST from the System instrument menu is equivalent to sending 
the *RST command to the System instrument. 


Figure 3-9 Resetting the System 
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Using the Loader Instrument 

The Loader instrument appears on the Select an instrument menu when the 
Flash ROMS Run/Load switch on the front of the Keysight El 406A Command 
Module is set to “Load”. This instrument allows you to: 

- Read the command module GRIB address 

- Configure the RS-232 port(s) 

- Set the system clock and calendar 

- Reset the system 

Using the Switchbox Menu 

The instrument menus allow you to access the most-used instrument functions 
or to monitor an instrument (monitor mode) while it is being controlled from 
remote. The Switchbox menu is used as an example to show you how to use the 
instrument menus. Menus are available for many, but not all, instruments. See 
your instrument user’s manual for more information on a particular instrument’s 
menu. The Switchbox menu allows you to: 

- Open and close channels 

- Scan channels 

- Display module (card) type and description 

- Reset a selected switch module 

- Monitor a switchbox 

Selecting the Switchbox 

To select the Switchbox, press the function key (fl - f5) which corresponds to the 
label SWITCH in the Select an instrument menu. (If the Select an instrument 
menu is not being displayed press UTILS then SELJNST.) 


NOTE 


After you press the function key for SWITCH, the screen may 
show: Select SWITCH at logical address:_ while the function key 
labels show two or more logical addresses. This means more than 
one switchbox is installed in the mainframe. To select one of the 
switchboxes, press the function key for the logical address key 
label. 


Figures 3-10 through 3-13 show how to use the switchbox menu. Keep the 
following points in mind when using the menu: 

- The card number identifies a module within the switchbox. The module 
with the lowest logical address is always card number 01. The module with 
the next successive logical address is card number 02, and so on. 
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Using the DispiayTerminai Interface 


- The @ character is required preceding a channel list when executing a 
switchbox command from the terminal interface or remote. When entering 
a channel list in response to a menu prompt, however, do not precede it 
with the @ character. Doing so causes a syntax error. 



Figure 3-10Opening and Closing Channels 
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/-\ 



Enter channel list and press RETURN 

(for example, 100;115 to scan channels 00 to 15 on card #1) 


V_/ 


Figure 3-11 Scanning Channels 
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SUITCH 32: 




scnN 

23 1 l|W 

nuKi; 

3 

UTILS 





Enter card number and press RETURN 


1 


SU1TCH_32: 

"lb Channel Relay Hux' 
TFKT 


SCPI command used: 
SYST:CDES <card_numbcr> 




Figure 3-12 Displaying Card Type and Description or Resetting Card 
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Monitor Mode 

Monitor mode displays the status of an instrument while it is being controlled 
from remote. Monitor mode is useful for debugging programs. You can place an 
instrument in monitor mode using terminal interface menus, or by executing the 
DISP:MON:STAT ON command from the terminal interface or by remote. Pressing 
most terminal interface keys will automatically exit monitor mode and return to 
the instrument menu. However, you can use the left and right arrow keys in 
monitor mode to view long displays. 


NOTE 


Enabling monitor mode slows instrument operations. If the timing 
or speed of instrument operations is critical (such as making 
multimeter readings at a precise time interval), you should not 
use monitor mode. 


SWITCH 32: 


iMssm 


SUITCH_32: 

Enter card nunber or AUTO 

I| 


T 


Enter card number or type AUTO and press RETURN 


SUITCH_32: 

^an: , , 

non 

1 | 


card 1 


SCPI commands used: 
DISP:MON:CARD <cani_iiiimhei-> 
DISP:MON:STATON 


Figure3-13Selecting Monitor Mode 
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Using the Display Terminal Interface 


Table 3-1 shows the status annunciators that may appear in the bottom line of 
the screen in monitor mode. Some instruments also have device-specific 
annunciators (see your specific module user’s manual for more information). 


Table 3-1 Monitor Mode Display Annunciators 


1 Annunciator 

Description I 

mon 

The instrument is in monitor mode. 

busy 

The instrument is executing a command. 

err 

An error has occurred (see “Reading Error Messages” below). A 

srq 

service request has occurred. 


Reading Error Messages 

Whenever the screen is showing the err annunciator, an error has occurred for 
the instrument being monitored. You can read the error message, although doing 
so cancels monitor mode. To read an error message, type SYST:ERR? (followed 
by pressing the Return key): 

The error message will be displayed in the bottom line of the Text Output Area. 
To see if another error was logged, repeat the SYST:ERR? command by pressing 
UTILS, RCL_PREV, then Return. 

After you have read all the error messages, executing the SYST:ERR? command 
causes the screen to show: +0,"No error". After reading the error message(s), 
press the fl key to return to monitor mode. 
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Executing Commands 


From the terminal interface, you can type and execute IEEE 488.2 common 
commands and SCPI commands for the instrument presently selected by the 
Select an instrument menu. (However, you cannot execute a command when the 
screen is requesting that you input information.) This is particularly useful for 
accessing functions not available in an instrument’s menu. For example, assume 
you want to program the Keysight El 411 B 5 1/2-Digit Multimeter for 10 DC 
voltage measurements. To specify 10 measurements you must type in the 
necessary command since the command is not on the multimeter menu. After 
selecting the VOLTMR menu, type the following commands and press the Return 
key after each command. 

CONF:VOLT:DC 

SAMP:COUN 10 

READ? 

These commands configure the multimeter, specify 10 measurements, and 
display the readings on the terminal. 


Editing the Terminal Display 

The screen editing keys allow you to edit user-entered data or commands. When 
editing, the screen is in insert mode. That is, typed characters will be inserted 
into the string at the present cursor position. 



The key labels shown are found on all HP terminals (except HP 
terminals supporting ANSI terminal protocol). See “Ung 
Supported Terminals” for equivalent key functions on your 
terminal. 
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General Key Descriptions 


This section explains the function of each of the terminal interface’s menu, menu 
control, and editing keys. If a key is not functional in a particular situation, 
pressing that key does nothing except to cause a beep. 


Menu and Menu Control Keys 


fi 


through 


f5 


SEL INST 


Label menu choices for corresponding function keys. 


Returns to the Select an instrument menu. 


PRV_MENU 


Returns to the previous menu level within an instrument menu or escapes from 
an input prompt. When you reach the top of an instrument’s menu, the 
PRV_MENU label disappears. 


The screen can show a maximum of five menu choices at a time. When there are 
more than five menu choices, function key f6 becomes labeled MORE. Press 
MORE to display the next group of choices. By repeatedly pressing MORE you 
can display all groups of choices. After you have displayed all groups of choices, 
pressing MORE again returns to the first group of choices. 


RCL_PREV 


Recalls the last command entered from the terminal interface. After recalling a 
command, it can be edited or re-executed. You can recall from a stack of 
previously executed commands by repeatedly pressing ROL_PRE\/. When you 
reach the bottom of the stack (the last line in the buffer), pressing ROL_PREV 
does nothing except to cause a beep. 


RCL_NEXT 


Recalls commands in the opposite order to that of RCL_PREV. Pressing 
RCL_NEXT does nothing until you have pressed RCL_PREV at least twice. 


Recalls the last SCPI command generated by a menu operation. For example, 
reading the time using the menus (SYSTEM, TIME, READ) generates and 
executes the SYSTTIME? SCPI command. A recalled command can be executed 
by pressing the Return key. You can edit a recalled command before you execute 
it. 
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General Key Descriptions 


Instrument Control Keys 

Resets only the selected instrument (equivalent of executing *RST). RST_INST 
also clears the instrument’s terminal interface and remote input and output 
buffers. RSTJNST is the only terminal interface key that can affect an instrument 
being operated from remote. 


RST_INST 


CLR_INST 


Clears the terminal interface input and output buffers (remote buffers are not 
cleared) of the selected instrument and returns to the top level of the instrument 
menu. Press CLRJNST whenever an instrument is busy, is not responding to 
terminal interface control, or to abort a command being entered from the 
terminal interface. 


Editing Keys 

Moves the cursor one character space to the right while leaving characters 
intact. 


Moves the cursor one character space to the left while leaving characters intact. 



Erases the character at the present cursor position (for user-entered data only). 


r A 

Cleor - 
End 


Erases all characters from the present cursor position to the end of the input line 
(for user-entered data only). 


Other Keys 

^ N Selects alternate key definitions. These CTRL key sequences provide short- cuts 
CTRL to some of the menu sequences and also provide some functions not directly 
available from dedicated terminal keys. Some alternate key definitions are: 

CTRL-R = Instrument Reset 
CTRL-C = Clear Instrument 
CTRL-D = Select an instrument menu. 

See Table 3-3 for a complete list of all control sequence functions. Users of the 
optional I BASIC interpreter should refer to their I BASIC manual set for additional 
editing functions. 
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Using Supported Terminals 

The display terminal interface supports several popular terminal brands and 
models. This chapter will show you how to access all of the terminal interface 
functions described previously using your supported terminal. 

The Supported Terminals 

The following list names the supported terminals and shows where to go for 
more information. If your terminal is not named in this list, see “Using Other 
Terminals”. 

- HP 700/92 Menu tutorial 

- HP 700/94 Menu tutorial 

- HP 700/22 See this page 

- HP 700/43 and WYSE WY-30 

The keyboard guides provided for the listed terminals may be removed or copied, 
and placed near your keyboard while you go through the menu tutorial sections. 

Using the HP 700/22 

The HP 700/22 terminal emulates the DEC VTIOO or VT220 terminals. Some 
functions of the display terminal interface have been mapped into keys with 
other labels. A keyboard map is provided for each of the emulation models. Use 
these keyboard maps to help locate the terminal interface functions. 
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VT100 Key Map 

The symbols shown in the upper left corner of key each are now mapped with the 
function labeled in the center of each key. 



Selecting VT100 Mode 

To use the HP 700/22 in VTIOO mode, press the Set-Up key and set the following 
configuration: 


1 Fields 

Value 1 

Terminal Mode 

EMI 00,7 bit Ctrls 

Columns 

80 

EMI 00 ID 

EMI 00 

Inhibit Auto Wrap 

YES 


VT220 Key Map 

The function keys that are normally labeled f6 through fl4 are now labeled: 



100 
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NOTE 


Because the HP 100/22 keyboard has nine function keys in the 
center of the keyboard, f4 is mapped twice. 


The symbols shown in the upper left corner of key each are now mapped with the 
function labeled in the center of each key. 



Selecting VT220 Mode 

To use the HP 700/22 in VT220 mode, press the Set-Up key and set the following 
configuration: 


Fields 

Value 

Terminal Mode 

EM200,7 bit Ctrls 

Columns 

80 

EM100ID 

EM220 

Inhibit Auto Wrap 

YES 
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Usingthe WYSE WY-30 

With the WYSE WY-30 terminal, some functions of the display terminal interface 
have been assigned to keys with other labels. Use this keyboard map to help 
locate these functions. 

The symbols shown in the upper left corner of key each are now mapped with the 
function labeled in the center of each key. 

Where two function key labels are shown, the one following the character is 
accessed by pressing and holding the CTRL key while pressing the desired 
function key (for example, to access the f6 function, press CTRL-f2/f6). 
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Using Other Terminals 

This section discusses using terminals which are not on the Supported Terminals 
list. Primarily this section is to help you use terminals which do not provide 
programmable soft keys (function keys). Without this capability, a terminal 
cannot access the display terminal interface’s menus. Instead, the terminal 
interface provides a set of terminal interface commands which allow you to 
select instruments by name or logical address. Once selected, you can type 
common commands or SCPI commands to the instrument. In addition, keyboard 
accessible control codes provide display control for terminals which may not 
have keys dedicated to those functions. 

What “Not Supported” Means 

strictly speaking, a terminal is not supported if it has not been rigorously tested 
with the display terminal interface. There are several HP terminals which may be 
compatible with the terminal interface. Terminals such as the DEC VTIOO, DEC 
VT220, and WYSE WY-50, or emulations of these may also work properly with 
the terminal interface. If you have one of these terminals, try it. Here is a list of 
terminals you should try. 

- HP 2392A 

- HP 2394A 

- DEC VTIOO 

- DECVT220 

- WYSE WY-50 

- HP AdvanceLink terminal emulation software (configure as HP 2392A) 

Testing Terminals for Compatibility 

Here is how you test an unsupported terminal for compatibility with the display 
terminal interface: 

1 Connect your terminal and configure its communication parameters to match 
the mainframe’s serial interface (see Appendix C). 

2 With your terminal turned on and set to "remote mode", turn on the 
mainframe. After the mainframe power-on self-test, the display interface 
sends sequences of characters to your terminal which should cause it to 
return its identification. If the terminal ID matches one In a list kept by the 
terminal interface, it will send character sequences to program the function 
keys and their labels. 

3 If you now see the Select an instrument prompt and the Select an instrument 
menu labels, your terminal is ready to try. Go to the beginning of this chapter 
and try the menus. 
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4 If you see only the Select an instrument prompt without the Select an 
instrument menu labels, your terminal did not return a recognized ID. To set 
the terminal type manually, type the terminal interface command: 

ST HP (followed by Return) for HP terminals - 700/94, 700/92, 26xx,23xx 

or 

STHP70043 (followed by Return) for the HP 700/43 terminal 
or 

STVT100 (followed by Return) forVTlOO emulators 
or 

ST VT220 (followed by Return) for VT220 emulators 
or 

ST WYSE30 (followed by Return) for WY-30 emulators 
or 

ST WYSE50 (followed by Return) for WY-50 emulators 

If you now see the Select an instrument menu labels, go to the beginning of this 
chapter and try the menus. 

or 

Turn the mainframe off and then on again. 

Continue with this chapter to learn how to use your terminal without menus. 

Using a Terminal Without Menus 

You can still control instruments installed in your mainframe without using the 
terminal interface menus. In this case you will send common commands and 
SCPI commands to your instruments by typing them on your terminal keyboard, 
or through a computer interface. 

Selecting Instruments 

To send commands to, and receive responses from an instrument, you must first 
select that instrument. Two commands are provided to select instruments. They 
are SI (Select Instrument), and SA (Select Address). These commands only work 
from the Select an Instrument prompt. The commands can be typed in upper 
case or lower case. 
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SI Command 

SI selects an instrument by its name, exactly as it would appear in the Select an 
instrument menu (see Table 3-2). If your mainframe has more than one 
instrument with the same name, follow the name with a comma (,) and the 
desired instrument’s logical address. Here are some examples of SI commands: 

- si voltmtr (selects a voltmeter instrument) 

- si switch (selects a switchbox instrument) 

- SI SWITCH (same as above) 

- si switch,!6 (selects switchbox at logical address 16) 


Table 3-2 Instrument Names for the SI Command 


1 Menu Name 

Instrument I 

SYSTEM 

The System Instrument (built-in to the command module) 

VOLTMTR 

E1326B Stand-Alone, or E1326B Scanning Voltmeter Modules 

SWITCH 

Switchbox composed of one or more Keysight Multiplexer Modules 

DIGJ/0 

E1330B Ouad 8-Bit Digital Input/Output Module 

IBASIC 

Optional IBASIC interpreter 

COUNTER 

El 332A 4-Channel Counter/Totalizer, or El 333A 3-Channel 

Universal Counter Modules 

D/A 

El 328A 4-Channel Digital-to-Analog Converter Module 


SA Command 

SA selects an instrument by its logical address. For multiple module instruments, 
use the logical address of the first module in the instrument. For example; SA 8 
selects the instrument at logical address 8. When you have selected an 
instrument, the terminal interface will respond with an instrument prompt which 
is the instrument’s menu name followed by its logical address (e.g., 
VOLTMTR_8:). 

To get a list of the logical addresses used in your mainframe, send the SCPI 
command VXI:CONF:DLAD? to the System instrument. Then, to determine what 
instrument is at each logical address, send the command VXI:CONF:DLIS? 
<logical_address> for each logical address in the list. Refer to page 189 for 
information about this command. 

Returning to the “Select an Instrument” Prompt 

To return to the Select an instrument prompt, press and hold the CTRL key then 
press the D key 
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Control Sequences for Terminal Interface Functions 

The terminal interface provides the keyboard control sequences listed in Table 
3-3. These can be thought of as keyboard short-cuts for compatible terminals 
(those which provide menu capability). Only those functions in the table marked 
with * (asterisk) operate for “UNOWN” terminal types (those which do not 
support menus). An “UNOWN” terminal type has very limited editing capability. It 
will not support the EDIT mode for the optional IBASIO interpreter. In the 
following table, t = IBASIO only. 


Table 3-3 Control Sequence Functions 


1 Terminal Key 

Function 

Control Sequence I 

Backspace* 

Deletes the character to the left of the cursor 
and moves cursor left. 

CTRL-H 

Del char 

Delete character at the cursor position. 

CTRL-X 

C[r->end 

Clears line from cursor position to end of line. 

CTRL-L 

Clear line 

Clears line regardless of cursor position. 

CTRL-U 

Insert line t 

Inserts a blank line at the cursor position. 

CTRL-0 

Delete line t 

Deletes the line at the current cursor position. 

CTRL-DEL 

End of line 

Move cursor to the end of current line. 

CTRL-Z 

Start of line 

Move cursor to the beginning of current line. 

CTRL-A 

Return* 

Terminates user entry. 

CTRL-M 

RCL_MENU 

Recalls the last command executed via the 
menu keys. 

CTRL-W 

RCLPREV* 

Recalls the last several commands executed via 
user input. 

CTRL-F 

RCL_NEXT* 

After RCLPREV, RCL_NEXT may be used to 
move forward through the recalled commands. 

CTRL-B 

SELJNST* 

Return to “Select an instrument” menu. 

CTRL-D 

CLRJNST* 

Clear instrument’s input and output buffers. 

CTRL-C 

RSTJNST* 

Like CLRJNST plus clears. 

CTRL-R 
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n Case of Difficulty 


1 Problem: 

Problem Cause/Solution: I 

Error -113 undefined header error occurs after entering data 
in response to a menu prompt. 

For some commands used by the menus, the data entered is 
appended to a command header. For example, if you enter “1 ” 
as the port number for a digital I/O module, the command 
used is DIG:HAND1 :MODE NONE where HANOI indicates the 
port number. If your entry was invalid or incorrect, error-113 
occurs. 

Following the power-on sequence or system reset the display 
shows: 

Configuration errors. Select SYSTEM Press any key 
to continue_ 

An unassigned device (incorrect logical address) was 
detected.. If you cycle power or perform system reset, the 
display will show the logical address of the unassigned 
device. You can also check the logical addresses using the 
CONFIG? — LADDS branch of the System instrument menu. 

You can also use SYSTERR? in the system instrument. 

The display shows: instrument in local lockout. 

Menus seem to work but nothing happens when 1 reach the 
bottom level or try to execute a command. 

The terminal interface has been locked-out (GPIB local 
lockout). You can re-enable menu operation by canceling 
local lockout (from remote) or by cycling mainframe power. 

Display cannot be removed from monitor mode. 

Monitor mode was entered (DISP:MON:STAT ON command) 
and the terminal interface has also been locked out (GPIB 
local lockout). Either cancel the local lockout or execute 
DISP:MON:STAT OFF (from remote). 

Display shows: 

Cannot connect to instrument 

Press any key to continue_ 

A hardware or software problem has occurred in the 
instrument preventing it from responding to terminal 
interface control. 

After selecting an instrument the display shows: 
busy 

The instrument is busy performing an operation. Press Clear 
Instr to abort the instrument operations and allow the 
terminal interface to access the instrument. 

Display shows: 

Instrument in use by another display 

Press any key to continue_ 

The instrument has already been selected from another 
terminal interface. An instrument can only be “attached” to 
one display at a time. At the other terminal interface, press 
Select Instr. The instrument can now be selected from the 
desired terminal interface. 
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System Instrument/Switchbox Menus 

This section contains charts showing the structure and content for the Keysight 
El 406A Command Module’s System instrument and switchbox terminal 
interface instrument menus. The SCPI commands used and descriptions of 
menu-controlled instrument operations are also included in the charts. You may 
want to refer to these charts as examples for other instrument menus. See the 
appropriate instrument user’s manual for menus specific to that instrument. 
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System Instrument/Switchbox Menus 
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4 Triggering and Systenn Status 


About This Chapter 

This chapter covers the use of the ECLTRG and TTLTRG* VXI backplane trigger 
lines and the Keysight E1406A Command Module’s Trig In and Trig Out ports. 
Also covered is the structure of the status system used by Keysight Technologies 
VXI instruments. 

The main sections of this chapter include: 


Using VXI Backplane Trigger Lines and Ports page 123 
Programming the Status System page 127 
Status System Programming Examples page 136 

Using VXI Backplane Trigger Lines and Ports 

Located on the P2 connector of the VXIbus backplane are trigger lines ECLTRGO 
- ECLTRGl and TTLTRGO* - TTLTRG7*. These lines are available for triggering, 
handshaking, timing, and so forth. The signal characteristics of these trigger 
lines and of the command module’s Trig In port are shown in Figure 4-1. 


ECLTRG 




HLTRG* 





ECLTRG Active Hi H>-0.9V 
L<-1.7V 


nLTRG’ Active Lo H>2.0V 
L<0.8V 


Figure 4-1 ECLTRG and TTLTRG* Signal Characteristics 
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Programming the Trigger Lines and the Trigger Ports 

The programming sequence used to set up the trigger lines and trigger ports is 
shown in Figure 4-2. Detailed information on the commands used can be found 
in Chapter 5 of this manual. 


NOTE 


In the following commands, <n> is 0 or 1 when selecting a 
ECLTRG trigger line, and 0 to 7 when selecting a TTLTRG* trigger 
line. Commands in square brackets ([ ]) are implied commands 
and are, therefore, optional. The brackets are not part of the 
command and are not sent to the instrument. 



Figure 4-2 Backplane Trigger and Trig Out Port Configuration Sequence 
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Enabling Trigger Lines and the Trig Out Port 

In order to use a trigger line or the Trig Out port, the trigger line or port must be 
enabled. This is done with the commands: 

OUTPut:ECLTrg<n>[:STATe] 1 | ON Enables a ECL trigger line. 

OUTPut:TTLTrg<n>[:STATe] 1 | ON Enables a TTL trigger line. 

OUTPut:EXTernal[:STATe] 1 | ON Enables the Trig Out port. 

The reset condition for each of these commands is OFF. Therefore, a trigger line 
or the Trig Out port must be enabled before it can be used. 

Setting the Trigger Source 

Once the trigger line or the Trig Out port has been enabled, the source which 
drives the trigger line can be specified. The commands used are: 

OUTPut:EOLTrg<n>:SOURce INT| EXT | NONE Selects ECL trigger source. 

OUTPut:TTLTrg<n>:SOURce INT | EXT | NONE Selects TTL trigger source. 

OUTPutEXTernaLSOURce INT| EOLTrg<n> |TTLTrg<n> | NONE 

Selects Trig Out port source. 

When the trigger source is INT, the trigger level is set using the OUTPut...:LEVel 
commands covered in the next section. When the Trig Out trigger source is 
EOLTrg<n> orTTLTrg<n>, the port is driven by the specified trigger line. When 
the trigger source is EXT, the trigger is supplied through the Trig In port. 

Notice that when the source is set, it remains set when the trigger state is set 
from ON to OFF. To disable a trigger line or the Trig Out port, first set the 
SOURce to NONE and then set STATe to OFF. 


Setting the Trigger Level 

When the trigger source is set to INT, the trigger level is controlled with the 
commands: 

OUTPut:EOLTrg<n>:LEVel[:IMMediate] 0 | 1 | OFF | ON 

Sets ECL trigger level. 

OUTPut:TTLTrg<n>:LEVel[:IMMediate] 0 11 | OFF | ON 

Sets TTL trigger level. 

OUTPut:EXTernal:LEVel[:IMMediate] 0 | 1 | OFF | ON 

Sets Trig Out trigger level. 

The commands used to set the TTLTrg and Trig Out port levels use negative 
logic. Thus, when a 1 or ON level is specified, the trigger line or port is set to a 
TTL low voltage level. 
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Sending a Trigger Pulse 

In certain VXI applications it may be necessary to send a single (trigger) pulse 
rather than continuously driving a trigger line. With the trigger line or the Trig 
Out port enabled (STATe ON) and the trigger source set to INT or NONE, you oan 
send a single pulse using the commands: 

OUTPut:EOLTrg<n>:IMMediate Sends a pulse on an ECL trigger line. 

OUTPut:TTLTrg<n>:IMMediate Sends a pulse on a TTL trigger line. 

OUTPut:EXTernal: IM Mediate Outputs a pulse at the Trig Out port. 

The pulse width is typically 60 pis. 

(Querying the Trigger State, Source, and Level 

You can determine the current trigger state, source, and level settings by adding 
a question mark (?) to the eommand used to set that parameter. For example: 

OUTPut:EOLTrg<n>[:STATe]? Quer/es state of EOL trigger line. 

OUTPut:TTLTrg<n>:LEVel[:IMMediate]? Quer/es level of TTL trigger line. 
OUTPut:EXTernal:SOURee? Quer/es source of Trig Out port. 
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Programming the Status System 

This section discusses the structure of the Standard Commands for 
Programmable Instruments (SCPI) STATus system and howto program the 
Status Registers. An important feature of SCPI instruments is that they all 
implement Status Registers in the same way. The status system is explained in 
the following sections: 

- General Status Register Model 

This section explains how Status Registers are structured in SCPI 
instruments. It also contains an example of how bits in the various registers 
change with different input conditions. 

- Required Status Groups 

This section describes the minimum required Status Registers present in 
SCPI instruments. These Status Registers cover the most frequently used 
functions. 

Example programs are also provided at the end of this chapter that illustrate how 
to use Service Requests to monitor events. 

General Status Register Model 

The generalized Status Register model shown in Figure 4-3 is the building block 
of the SCPI status system. This model consists of a Condition Register, Transition 
Filter, an Event Register, and an Enable Register. A set of these registers is called 
a status group. 


Condition fronsilion tvent Enoble 

Register Filter Register Register 



Figure 4-3 Generalized Status Register Model 


When a status group is implemented in an instrument, it always contains all of 
the component registers. However, there is not always a corresponding 
command to read or write to every register. 
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Condition Register 

The Condition Register continuously monitors the hardware and firmware status 
of the instrument. There is no latching or buffering for this register; it is updated 
in realtime. Condition Registers are read-only. 

If there is no command to read a particular Condition Register, it is simply 
invisible to you. 

Transition Filter 

The Transition Filter specifies which types of bit state changes in the Condition 
Register will set corresponding bits in the Event Register. Transition Filter bits 
may be set for positive transitions (PTR), negative transitions (NTR), or both. 
Positive means a condition bit changes from 0 to 1. Negative means a condition 
bit changes from 1 to 0. Transition Filters are read-write, and are unaffected by 
*CLS (clear status) or queries. They are set to instrument-dependent values at 
power on and after *RST (reset). 

If there are no commands to access a particular Transition Filter, it has a fixed 
setting. This setting is specified in the instrument’s programming guide or 
command dictionary. Most of our VXI instruments assign the Transition Filter to 
detect positive transitions only. 

Event Register 

The Event Register latches transition events from the Condition Register as 
specified by the Transition Filter. Bits in the Event Register are latched, and, once 
set, they remain set until cleared by a query or *CLS (clear status). There is no 
buffering; so while an event bit is set, subsequent events corresponding to that 
bit are ignored. Event Registers are read-only. 

Enable Register 

The Enable Register specifies which bits in the Event Register can generate a 
summary bit. The instrument logically AMDs corresponding bits in the Event and 
Enable Registers, and ORs all the resulting bits to obtain a summary bit. 
Summary bits are, in turn, recorded in another register, often the Status Byte. 
Enable Registers are read-write, and are not affected by *CLS (clear status). 
Querying Enable Registers does not affect them. There is always a command to 
read and write to the Enable Register of a particular status group. 

An Example Sequence 

Figure 4-4 illustrates the response of a single bit position in a typical status 
group for various settings. The changing state of the condition in question is 
shown at the bottom of the figure. A small binary table shows the state of the 
chosen bit in each Status Register at the selected times T1 - T5. 
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Figure 4-4 Typical Status Bit Changes in a Status Register 


Required Status Groups 

All SCPI instruments must implement a minimum set of status groups. Some 
instruments contain additional status groups, consistent with the general status 
register model. The minimum required status system is shown in Figure 4-5. 
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Questionable Dato 



Figure 4-5 Minimum Required Status Register System 


The Standard Operation Status and Questionable Data Groups are 16-bits wide, 
while Status Byte and Standard Event Groups are only 8-bits wide. In all 16-bit 
groups, the most significant bit (bit 15) is not used. Bit 15 always returns a zero. 
The commands that set and query bits in the Status Registers all use decimal 
integers. For example, you send *ESE 4 to set bit 2 of the Standard Event Enable 
Register. Similarly, a response of "8" to the query *ESE? indicates that bit 3 is set. 
The remainder of this chapter explains each status group in detail. 
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Status Byte Group 

As Figure 4-6 indicates, the Status Byte is used to summarize information from 
all the other status groups. The Status Byte differs from the other groups in the 
way you read it and how its summary bit is processed. 


Status Byte 



Figure 4-6 Status Byte Register 


The Status Byte can be read using either the *STB? common command or by 
doing a SICL ireadstb function call. The ireadstb function reads the Status Byte 
from the device specified. 

The Status Byte Summary bit actually appears in bit 6 (RQS) of the Status Byte. 
When bit 6 is set, it generates an SRQ interrupt. This interrupt is a low-level GPIB 
message that signals the controller that at least one instrument on the bus 
requires attention. 

There are some subtle differences between *STB? and ireadstb. You can use 
either method to read the state of bits 0-5 and bit 7. Bit 6 is treated differently 
depending on whether you use *STB? or ireadstb. With ireadstb, bit 6 returns 
RQS (request for service) which is cleared after the first ireadstb. *STB? returns 
the MSS (master state summary). This is the Summary bit of the Status Byte 
Register. It is like a condition bit and will return to zero only when all enabled bits 
in the Status Byte are zero. In general, use ireadstb inside interrupt service 
routines, not *STB?. 
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NOTE 


In an SRQ interrupt service routine, you must clear the Event 
Register which caused the SRQ (for example, STAT:QUES:EVEN?, 
STAT:OPER:EVEN?, or *ESR?). Failure to do so will prevent future 
SRQs from arriving. 


The meaning of each bit in the Status Byte is explained in the following table. 


Table 4-1 Status Byte Bit Definitions 


Bit 

Name 

Description 

0 


Instrument dependent 

1 


Instrument dependent 

2 


Instrument dependent 

3 

OUE 

Summary bit from Questionable Data 

4 

MAV 

Messages available in Output Queue 

5 

ESB 

Summary bit from Standard Event 

6 

RQS 

Service request 

7 

OPR 

Summary bit from Standard Operation Status 


Example commands using the Status Byte and Status Byte Enable Registers: 
*SRE 16 Generate an SRQ interrupt when messages are available. 
*SRE? Find out what events are enabled to generate SRQ interrupts. 
*STB? Read and olear the Status Byte Event Register. 

Standard Event Status Group 

The Standard Event Status Group is frequently used and is one of the simplest. 
The unique aspect of Standard Event is that you program it using common 
commands, while you program all other status groups through the STATus 
subsystem. Standard Event consists of only two registers: the Standard Event’s 
Event Register and the Standard Event’s Enable Register. Figure 4-7 illustrates 
the structure of Standard Event. 
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Operation Connplete (OPC) 
Request Control (RC) 
Query Error (QYE) 
Device Dependent Error (DDE) 
Execution Error (EXE) 
Commond Error (CME) 
User Request (URQ) 
Power On (PON) 



Figure 4-7 Standard Event Status Group 


Example commands using Standard Event Registers: 

*ESE 48 Generate a Summary bit on execution or command errors. 
*ESE? Query the state of the Standard Event’s Enable Register. 

*ESR? Query the state of the Standard Event’s Event Register. 

Standard Operation Status Group 

The standard Operation Status Group provides information about the state of the 
measurement systems in an instrument. This status group is accessed through 
the STATUS subsystem. Standard Operation Status includes a Condition Register, 
Event Register, and an Enable Register. As a beginner, you will rarely need to use 
this group. Figure 4-8 illustrates the structure of Standard Operation Status. 
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Colib''atlng 

Setting 

Ponging 

Sweeping 

Measuring 


Waiting for TRIG 
Waiting for ARM 


Correction 

ID 


NOTE; 

ID = lnstrument 
Dependent 


ID 

ID 

ID 

ID 


iNSTrument Summary 
PROGram Running 
Aiwoys Zero 



Figure 4-8 Standard Operation Status Group 


Questionable Data Group 

The Questionable Data Status Group provides information about the quality of 
instrument output and measurement data. Questionable Data is accessed 
through the STATus subsystem. As a beginner, you will rarely need to use this 
status group. Figure 4-9 illustrates the structure of Questionable Data. 
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Figure 4-9 Questionable Data Status Group 
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Status System Programming Examples 

This section contains two example programs that use the status system and 
common commands to monitor when data is available from an instrument and 
when an error has occurred. Both programming examples are written in C and 
use the Standard Instrument Control Library (SICL) for I/O operations. The 
example programs use SCPI (Standard Commands for Programmable 
Instruments) commands to communicate with the status system. Thus, the 
instruments must either be message-based or have a SCPI interpreter, such as 
an Keysight E1406A Command Module or the SICL iscpi Interface. 

Handling SR(5s 

The following is a general procedure for handling SRQs: 

- Define the SRQ handler to do the following: 

— Read the Status Byte using ireadstb. ireadstb returns the RQS (request 
for service) bit in bit 6 of the status byte. After issuing an ireadstb, RQS 
is cleared indicating that the Service Request is being acknowledged. A 
new SRQ will not be issued unless RQS is cleared. Using *STB? will 
return the Master State Summary in bit 6 and does not affect RQS, 
therefore this should not be used in a SRQ handler. 

— Check the status byte to determine which status group(s) requires 
service. 

— For each status group that requires service, read the Event Register of 
that status group to determine what caused the SRQ to be generated. It 
is necessary to clear the Event Register so that if a new event occurs a 
new SRQ will be generated. 

— Take some action after determining which event caused the SRQ. The 
action taken is determined by evaluating the contents of the Event 
Register. 

- Enable SRQ Handler in SICL with ionsrq. 

- Make sure that all the Enable Masks in all the Status Enable Registers are 
set to the proper values to propagate the Summary bit(s) to the Status 
Byte. An SRQ is only generated if the MSS (Master State Summary) bit in 
the status byte is set. 

Using Message Available (MAV) Bits 

Message Available (MAV) bits can be used to determine when data is available. 
The following example program sets up an SRQ handler to be called when there 
is data in the output queue. The program then prompts for SCPI commands. If 
the SCPI command results In data in the output queue (such as a query 
command), then the SRQ handler is called and the data is printed. 
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The following summarizes the procedure used: 

- Define an SRQ handler to do the following: 

— Read the Status Byte using ireadstb. ireadstb returns the RQS (request 
for service) bit in bit 6 of the status byte. After issuing a ireadstb, RQS is 
cleared indicating that the Service Request is being acknowledged. A 
new SRQ will not be issued unless RQS is cleared. Using *STB? will 
return the Master State Summary in bit 6 and does not affect RQS. 

— Check if the MAV bit (bit 4) is set to indicate that a message is available. 
If the MAV bit is set, then a message is available and the SRQ handler 
can process the message. In this example, the output queue is read 
using iscanf. 

- Enable SRQ Handler in SICL with ionsrq. 

- Enable Message Available (MAV) bit in the Status Byte Enable Register 
(e.g. *SRE 16). This will cause an SRQ to arrive when there is a message in 
the output queue (for example, data is available to be read). 

Example Program 

/* The following program provides an interactive command line 
interface */ 

/* to send SCPI commands to SCPI compatible instruments. */ 

/* This utilizes the MAV bit of the Status Byte in order to determine 
if the */ 

/* instrument is returning any output. */ 

#include <sicl.h> 

#include <stdio.h> 

/* Theses are Masks for the Status Byte */ 

/* all bits start at bit 0 */ 

#define MAV_MASK 0x10/* MAV - bit 4 */ 

/* This is the SRQ handler to check for Message Available (MAV) */ 

void srq_hdlr( INST id) { 

unsigned char stb; char buf[255]; 

int esr; 

int errnum; 

char errmsg[100]; 

/* read the status byte to determine what caused the SRQ. */ 

/* Note: use ireadstb instead of *STB? because you want to */ 

/* clear RQS instead of reading the MSS bit in the status byte. */ 
ireadstb(id, &stb); 

/* check if MAV caused the SRQ */ 
if( MAV_MASK == (stb & MAV_MASK)) 

{ 

Continued on next page 
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/* message is available so read in the result. */ 
iscanf( id, "%t", buf); 
printf("%s", buf); 

} 

} 

void main(){ INST id; 

char addr[80]; char cmd[255]; int opc; 

int idx; 

printf("This program provides an interactive environment for SCPI \ 
n"); 

printf("compatible instruments. \n\n"); 

printf("Enter the SICL address of the instrument to open.\n"); 

printf("for example: iscpi,24)\n"); 

gets(addr); 

/* install error handler */ 
ionerror( I_ERROR_EXIT); 

/* open the instrument specified by the user */ 
id = iopen(addr); 

itimeout( id, 20000);/* 20 second timeout */ 

/* set up SRQ handler */ 
ionsrq( id, srq_hdlr); 

/* enable MAV (bit 4) in status byte to cause an SRQ */ 
iprintf( id, "*SRE %d\n", MAV_MASK ); 

/* make sure *SRE finished */ 

ipromptf( id, "*OPC?\n", "%d", &opc);/* opc value not used */ 
printf("\nEnter SCPI Commands/Queries to Instrument at %s\n", addr); 
printf(" (press return to exit)\n\n"); 
while(l) 

{ 

while(0 == gets(cmd)); 

if( 0 == strlen(cmd)) 

break;/* quit sending SCPI Commands */ 

/* send command */ 
iprintf(id, "%s\n", cmd); 

/* check cmd for a , if found assume it is a query */ 
for(idx=0; idx<strlen(cmd); idx++) 
if( == cmd[idx]) 

{ 

/* wait up to 1 minute for srq handler */ 
if( 0 != iwaithdlr(60000)) 

{ 

printf("ERROR: Failed to process Query\n"); 
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} 

Continued on next page 
break; 

} 

}/* while - there are commands to send */ 

/* remove the handler */ 
ionsrq( id, 0); 

/* close the session */ 

printf("\nClosing Instrument at %s\n", addr); 
iclose(id); 

} 

Using a Service Request (SRQ) 

A Service Request (SRQ) can be used to detect errors. The following example 
program sets up an SRQ handler to be called when SCPI errors are detected 
using the Standard Event Status Register. The program then prompts for SCPI 
commands. If the SCPI command results In data In the output queue (such an 
query command) or an error, then the SRQ handler is called and the data is 
printed. 

The following summarizes the procedure used: 

- Define a SRQ Handler which does the following: 

— Read the Status Byte using ireadstb. ireadstb returns the RQS (request 
for service) bit in bit 6 of the status byte. After issuing a ireadstb, RQS is 
cleared indicating that the Service Request is being acknowledged. A 
new SRQ will not be issued unless RQS is cleared. Using *STB? will 
return the Master State Summary in bit 6 and does not affect RQS. 

— Check if the MAV bit (bit 4) is set to indicate that a message is available. 
If the MAV bit is set, then a message is available and the SRQ handler 
can process the message. In this example, the output queue is read 
using iscanf. 

— Check if the Standard Event Status Summary bit (bit 5) is set. If the bit is 
set, then read the Standard Event Status Group’s Event Register to 
determine which event(s) caused the SRQ. Check for Command Error 
(bit 5), Execution Error (bit 4), Device Dependent Error (bit 3), or Query 
Error (bit 2). If found, read the error queue with SYST:ERR? to print out 
error messages. 

- Enable SRQ Handler in SICL with ionsrq. 

- Enable MAV bit (Message Available Bit) and Standard Event Status 
Register Summary bit in the Status Byte Enable Register (for example, 
*SRE 48). This will cause an SRQ to arrive when there is a message in the 
output queue or when the summary bit is set in the standard event status 
register. 
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- Enable the Command Error, Execution Error, Device Dependent Error, and 
Query Error Enable bits in the Standard Event Status Enable Register (e.g. 
*ESE 60). This will cause the Summary bit of the Standard Event Status 
Register to be set when an error occurs. 

Example Program 

/* The following program provides an interactive command line 
interface */ 

/* to send SCPI commands to SCPI compatible instruments. */ 

/* This utilizes the MAV bit of the Status Byte in order to determine 
if */ 

/* the instrument is returning any output. It also automatically */ 

/* displays any error conditions that may result by querying the 
Standard */ 

/* Event Status Register. */ 

#include <sicl.h> 

#include <stdio.h> 

/* Theses are Masks for the Status Byte */ 

/* all bits start at bit 0 */ 

#define MAV_MASK 0x10/* MAV - bit 4 */ 

#define ESR_MASK 0x20/* ESR summary - bit 5 */ 

/* These are Masks for the Standard Event Status Register */ 

/* all bits start at bit 0 */ 

#define QRY_ERR_MASK 0x04 /* query error - bit 2 */ 

#define DEV_ERR_MASK 0x08 /* device dependent error - bit 3 */ 
#define EXE_ERR_MASK 0x10 /* execution error - bit 4 */ 

#define CMD_ERR_MASK 0x20 /* command error - bit 5 */ 

/* This is the SRQ handler to check for Message Available (MAV) */ 

/* or any error conditions */ 
void srq_hdlr( INST id) 

{ 

unsigned char stb; 
char buf[255]; 
int esr; 
int errnum; 
char errmsg[100]; 

/* read the status byte to determine what caused the SRQ. */ 

/* Note: use ireadstb instead of *STB? because we want to */ 

/* clear RQS instead of reading the MSS bit in the status byte. */ 
ireadstb(id, &stb); 

/* check if MAV caused the SRQ */ 
if( MAV_MASK == (stb & MAV_MASK)) 

{ 
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/* message is available so read in the result */ 
iscanf( id, "%t", buf); 
printf("%s", buf); 

} 

else /* check if Standard Event Status */ 
if( ESR_MASK == (stb & ESR_MASK)) 

{ 

/* read the standard event register to determine what caused the ESR 
*/ 

/* summary bit to be set. This is necessary in order to get future */ 
/* SRQ^s from the Standard Event status group. */ 
ipromptf(id, "*ESR?\n", "%d\n", &esr); 

/* check if an error caused the summary bit to get set */ if( 
(CMD_ERR_MASK == (esr & CMD_ERR_MASK )) || (EXE_ERR_MASK == (esr & 
EXE_ERR_MASK )) || (DEV_ERR_MASK == (esr & DEV_ERR_MASK )) || 
(QRY_ERR_MASK == (esr & QRY_ERR_MASK ))) 

{ 

Continued on next page 

/* an error occurred, read the error queue to get the error */ 
errnum = -1; 
while( errnum != 0) 

{ 

ipromptf( id, "SYST:ERR?\n", "%d,%t", Sermurn, errmsg); 
if( errnum != 0) 

printf("%d,%s", errnum, errmsg); 

} 

} 

} 

} 

void main() 

{ 

INST id; 

char addr[80]; char cmd[255]; int opc; 
int idx; 

printf("This program provides an interactive environment for SCPI \ 
n"); 

printf("compatible instruments. \n\n"); 

printf("Enter the SICL address of the instrument to open.\n"); 

printf("for example: iscpi,24)\n"); 

gets(addr); 

/* install error handler */ 
ionerror( I_ERROR_EXIT); 

/* open the instrument specified by the user */ 
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id = iopen(addr); 

itimeout( id, 20000);/* 20 second timeout */ 

/* set up SRQ handler */ 
ionsrq( id, srq_hdlr); 

/* enable MAV (bit 4) and Standard Event Status Summary (bit 5) 

* in status byte to cause an SRQ */ 

iprintf( id, "*SRE %d\n", MAV_MASK | ESR_MASK); 

/* enable ERROR Bits to generate a ESR summary message */ 

iprintf( id, "*ESE %d\n", CMD_ERR_MASK | EXE_ERR_MASK | DEV_ERR_MASK 
QRY_ERR_MASK); 

/* make sure *SRE and *ESE finished */ 

ipromptf( id, "*OPC?\n", "%d", &opc);/* opc value not used */ 
printf("\nEnter SCPI Commands/Queries to Instrument at %s\n", addr); 
printf(" (press return to exit)\n\n"); 

while(l) 

{ 

while(0 == gets(cmd)); 

if( 0 == strlen(cmd)) 

break;/* quit sending SCPI Commands */ 

Continued on next page 
/* send command */ 
iprintf(id, "%s\n", cmd); 

/* check cmd for a if found assume it is a query */ 

for(idx=0; idx<strlen(cmd); idx++) 
if( == cmd[idx]) 

{ 

/* wait up to 1 minute for srq handler */ 
if( 0 != iwaithdlr(60000)) 

{ 

printf("ERROR: Failed to process Query\n"); 

} 

break; 

} 

} /* while - there are commands to send */ 

/* remove the handler */ 
ionsrq( id, 0); 

/* close the session */ 

printf("\nClosing Instrument at %s\n", addr); 
iclose(id); 

} 
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About This Chapter 

This chapter describes the Standard Commands for Programmable Instruments 
(SCPI) command set and the IEEE 488.2 Common Commands for the System 
instrument and the Loader instrument. The System instrument is part of the 
E1406A Command Module’s internal control processor and is, therefore, always 
present in the command module. 

The Flash ROMS Run/Load switch on the front of 
the E1406A Command Module must be in the "Run" 
position to access the System instrument. The 
Run/Load switch must be in the "Load" position to 
access the Loader instrument. This chapter contains 
the following sections: 

Command Types page 143 
SCPI Command Reference page 147 
Common Command Reference page 264 
GPIB Message Reference page 273 
Common Commands Quick Reference page 277 
Common Commands Quick Reference page 277 



Command Types 

Commands are separated into two types: IEEE 488.2 Common Commands and 
SCPI Commands. 


Common Command Format 


The IEEE 488.2 standard defines the common commands that perform functions 
like reset, self-test, status byte query, and so forth. Common commands are four 
or five characters in length, always begin with an asterisk (*), and may include 
one or more parameters. The command keyword is separated from the first 
parameter by a space character. Some examples of common commands are: 



KEYSIGHT 

TECHNOLOGIES 


*RST, *ESE <mask>, *STB? 
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SCPI Command Format 

SCPI commands perform functions like closing switches, making measurements, 
and querying instrument states or retrieving data. A subsystem command 
structure is a hierarchical structure that usually consists of a top level (or root) 
command, one or more lower level commands, and their parameters. 

The following example shows part of a typioal subsystem: 

[ROUTe:] 

CLOSe <channel_list> 

SCAN <channel_list> 

MODE? 

[ROUTe:] is the root command, CLOSe and SCAN are second level commands 
with parameters, and :MODE? is a third level eommand. [ROUTe:] is also an 
implied command and is, therefore, optional. 


Command Separator 

A colon (:) always separates one command from the next lower level command 
as shown below: 

ROUTe:SCAN:MODE? 

Colons separate the root command from the second level command 
(ROUTe:SCAN) and the second level from the third level (SCAN:MODE?). 

Abbreviated Commands 

The command syntax shows most commands as a mixture of upper and lower 
case letters. The upper case letters indicate the abbreviated spelling for the 
command. For shorter program lines, send the abbreviated form. For better 
program readability, you may send the entire command. The instrument will 
accept either the abbreviated form or the entire command. 

For example, if the command syntax shows DIAGnostic, then DIAG and 
DIAGNOSTIC are both acceptable forms. Other forms of DIAGnostic, such as 
DIAGN or DIAGNOS will generate an error. You may use upper or lower case 
letters. Therefore, DIAGNOSTIC, diagnostic, and DiAgNoStIc are all acceptable. 
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Implied Commands 

Implied commands appear in square brackets ([ ]) in the command syntax. (The 
brackets are not part of the command, and are not sent to the instrument.) 
Suppose you send a second level command but do not send the preceding 
implied command. In this case, the instrument assumes you intend to use the 
implied command and it responds as if you had sent it. Examine the [SOURce:] 
subsystem shown below: 

[SOURce:] 

PULSe 

:COUNt 

:COUNt? 

:PERiod 

:PERiod? 

The root command [SOURce:] is an implied command. To set the instrument’s 
pulse count to 25, you can send either of the following command statements: 

SOUR:PULS:OOUN 25 or PULS:OOUN 25 

Variable Command Syntax 

Some commands have what appears to be a variable syntax. For example: 

DIAG:INT:SETup[n]? and SYST:OOMM:SERial[n]:BAUD? 

In these commands, the "n" is replaced by a number. No space is left between 
the command and the number because the number is not a parameter. The 
number is part of the command syntax. The purpose of this notation is to save a 
great deal of space in the command reference. In the case of ...SETup[n], [n] 
could range from 1 through 7. In ...SERial[n]? , [n] can be from 0 through 7. You 
can send the command without the [n] and a default value will be used by the 
instrument. Some examples: 

DIAG:INT:SET2?, DIAG:INT:PRI2 5, SYST:GOMM:SERl:BAUD 9600 

Parameter Types 

The following list contains explanations and examples of parameter types you 
will see later in this chapter. 

- Arbitrary Block Program Data parameters are used to transfer blocks of data in 
the form of bytes. The block of data bytes is preceded by a preamble which 
indicates either 1) the number of data bytes which follow, or 2) that the 
following data block will be terminated upon receipt of a New Line 
message with the EOl signal true. The syntax is: 
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Definite Length Block 

#<non-zero digit><digit(s)><data byte(s)> 

Where the value of <non-zero digit> equals the number of 
<digit(s)>. The value of <digit(s)> taken as a decimal integer 
indicates the number of <data byte(s)> in the block. 

Indefinite Length Block 
#0<data byte(s)><NL^END> 

Examples of sending 4 data bytes: 

#14 < byte > < byte > < byte > < byte > 

#3004 < byte > < byte > < byte > < byte > 

#0 < byte > < byte > < byte > < byte ><NL^END> 

- Boolean Parameters represent a single binary condition that is either true or 
false (for example, ON, OFF, 1,0). Any non-zero value is considered true. 

- Discrete Parameters selects from a finite number of values. These 
parameters use mnemonics to represent each valid setting. An example is 
the OUTPut:EXTernal:SOURce <source> command where source can be 
INTernal, EOLTrgO, EOLTrgl, TTLTrgO, TTLTrgl, TTLTrg2, TTLTrgS, and so 
on. 

- Numeric Parameters are commonly used decimal representations of numbers 
including optional signs, decimal points, and scientific notation (for 
example, 123, 123E2, -123, -1.23E2, .123, 1.23E-2, 1.23000E-01). 
Special cases include MIN, MAX, DEFault, and INFinity. 

The “ Oomments” section within the Oommand Reference will state 
whether a numeric parameter can also be specified in hex (#H7B), octal 
(#0173), and/or binary (#61111011). 

- Optional Parameters are parameters shown within square brackets ([ ]), and 
are optional. (Note that the brackets are not part of the command, and are 
not sent to the instrument.) If you do not specify a value for an optional 
parameter, the instrument chooses a default value. For example, consider 
the ARM:OOUNt? [<MIN | MAX>] command. If you send the command 
without specifying a parameter, the present ARM:COUNt value is returned. 
If you send the MIN parameter, the command returns the minimum count 
available. If you send the MAX parameter, the command returns the 
maximum count available. Be sure to place a space between the command 
and the parameter. 
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Linking Commands 

Linking IEEE 488.2 Common Commands with SCPI Commands. 

Use a semicolon (;) between the commands. For example: 

*RST;OUTPON or TRIG:SOUR HOLD;mRG 

Linking Multiple SCPI Commands. Use both a semicolon and a colon between 
the commands. For example: 

ARM:COUN l;:TRIG:SOUR EXT 

SCPI Command Reference 

This section describes the SCPI commands for the System instrument and 
Loader instrument. Commands are listed alphabetically by subsystem and also 
within each subsystem. 

DIAGnostic Subsystem page 148 
OUTPut Subsystem page 180 
PROGram Subsystem page 192 
STATUS Subsystem page 197 
SYSTem Subsystem page 204 
VXI Subsystem page 224 
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DIAGnostic Subsystem 

The DIAGnostic subsystem allows control over the System instrument’s internal 
processor system (:BOOT and :INTerrupt), access to the Loader instrument, 
allocation and contents of user RAM and disc volume RAM (:NRAM and :RDISk), 
and allocation of the built-in serial interface (DIAG:COMM:SER[0]:OWN). 


Subsystem Syntax 

DIAGnostic 

:BOOT 

:COLD 

[:WARM] 

:COMMunicate 

:SERial[0] 

[:OWNer] <owner> | SYSTem | IBASic | NONE 
[:OWNer]? 

:SERial[n] 

:STORe 

:DOWNIoad 

:CHECked 

[:MADDress] <address>,<data> 

:SADDress <address>,<data> 

[:MADDress] <address>,<data> 

:SADDress <address>,<data> 

:DRAM 

:AVAilable? 

:CREate <size> | MIN | MAX,<num_drivers> | MIN | MAX | DEE 
:CREate? [<MIN | MAX>,<MIN | MAX | DEF>] 

:DRIVer 

:INSTall 

:LIST 

[:ALL]? 

:FROM? 

:RAM? 

:ROM? 

:LOAD <driver_block> 

:CHECked <driver_block> 

:FROM 

:AVAilable? 

:CREate <num_drivers> 

:CREate? 

:SIZE? 

:INTerrupt 

:ACTivate <mode> | 0 11 | OFF | ON 
:PRIority[n] <level> | MIN | MAX | DEE 
:PRIority[n]? 
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:RESPonse? 

:SETup[n] <mode> | 0 11 | OFF | ON 
:SETup[n]? 

:NRAM 

:ADDRess? 

:OREate <size> | MIN | MAX 
:OREate? [MIN | MAX] 

:PEEK? <address>,<width> 

:POKE <address>,<width>,<data> 

:RDISk 

:ADDRess? 

:OREate <size> | MIN | MAX 
:OREate? [MIN | MAX] 

:UPLoad 

[:MADDress]? <address>,<byte_count> 
SADDress? <address>,<byte_count> 


:BOOT:COLD 

DIAGnostic:BOOT:OOLD causes the System instrument to restart (reboot). 
Oonfigurations stored in non-volatile memory and RS-232 configurations are 
reset to their default states: 

- DRAM, NRAM, and RDISk memory segments are cleared. 

- Serial Interface parameters for the internal serial interface and for any 
plug-in serial cards (Keysight E1324A) that are in the command module’s 
servant area are set to: 

- BAUD 9600 

- BITS 8 

- PARityNONE 

- SBITs 1 

- DTR ON 

- RTS ON 

- PAOEXON 

- Serial 0 Owner = system 
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NOTE 


Resetting the serial interface parameters takes about 0.01 
seconds for the built-in serial port and 0.75 seconds per serial 
plug-in card. While this is taking place the System instrument will 
still respond to serial polls. If you are using a serial poll to 
determine when the cold boot cycle is complete, you should insert 
a delay of 1 second per plug-in serial card (Keysight E1324A) 
before polling the System instrument. This will prevent incorrectly 
determining that the System instrument has completed its boot 
cycle. 


Comments 

- The System instrument goes through its power-up self tests. 

- Related Commands: DIAG:BOOT[:WARM] 

Example 

Reboot the System Instrument (cold) 

DIAG:BOOT:COLD Force boot. 

:BOOT[:WARM] 

DIAGnostic:BOOT[:WARM] causes the System instrument to restart (reboot) 
using the current configuration stored in non-volatile memory. The effect is the 
same as cycling power. 

Comments 

- The System instrument goes through its power-up self tests. 

- The Non-volatile system state is used for configuration wherever 
applicable. 

- DRAM, NRAM, and RDISk memory segments remain intact. 

- Related Commands: DIAG:BOOT:COLD 

Example 

Boot the System Instrument (warm) 

DIAG:BOOT- Force boot. Note that :WARM is implied. 
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:COMMunicate :SERia[[0][:OWNer] 

DIAGnostic:COMMunicate:SERia[[0][:OWNer] <owner> allocates the built-in 
serial interface to the System instrument (SYSTem), the optional IBASIC 
interpreter (IBASic), or to neither (NONE). 

Parameters 


Parameter 

Name 

Parameter Type 

Range of Values 

Default 

Units 

<owner> 

discrete 

SYSTem | IBASic | NONE 

none 


Comments 

- While the serial interface is allocated to the command module (SYSTem), it 
can function as the mainframe user interface when connected to a 
terminal or computer running terminal emulation software. 

- When the built-in serial interface is allocated to IBASic, it is controlled only 
by IBASIC. The serial interface is given a select code of 9, and any RS-232 
device connected to the command module’s RS-232 port is programmed 
accordingly. Note that when IBASIC owns the serial interface there is no 
"front panel" interface to the system. 

- If the built-in serial interface is not needed, specifying NONE will release 
memory for use by other instruments. 

- Once the new serial interface owner has been specified 
(DIAG:COMM:SER:OWN), the change will not take effect until you reboot 
(warm) the system. 

- Related Commands: DIAG:COMM:SER[0][:OWN]? 

Example 

Give the Serial Interface to IBASIC 

DIAG:COMM:SER IBAS Note that 0 (zero) and :OWNer are implied. 
DIAG:BOOT:WARM Complete the allooation. 
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:COMMunicate :SERia[[0][:OWNer]? 

DIAGnostic:COMMunicate:SERia[[0][:OWNer]? returns the current "owner" of the 

built-in serial interface. The values returned will be; SYST, IBAS, or NONE. 

Comments 

- Related Commands: DIAG:COMM:SER[0][:OWN] 

Example 

Determine Which Instrument has the Serial Interface 

DIAG:COMM:SER? Note that 0 (zero) and :OWNer are implied. 
enter statement Statement returns the string SYST, IBAS, or NONE. 

iCOMMunicate :SERia[[n]:STORe 

DIAGnostic:COMMunicate:SERIal[n]:STORe stores the serial communications 

parameters (for example, BAUD, BITS, PARity, and so on) into Non-volatile 

storage for the serial interface specified by [n] in SERial[n]. 

Comments 

- Until DIAG:COMM:SER[n]:STORe is executed, communication parameter 
values are stored in volatile memory, and a power failure will cause the 
settings to be lost. 

- DIAG:COMM:SER[n]:STORe stores the serial interface’s communications 
parameters. Card number 0 (in place of [n]) specifies the command 
module’s built-in interface while 1 through 7 specifies one of up to seven 
Keysight El 324A B-size plug-in serial interface modules. Be aware that the 
Keysight E1324A module stores its settings in an on-board EEROM. This 
EEROM write cycle takes nearly one second to complete. Wait for this 
operation to complete before attempting to use that serial interface. 

- The Keysight El 324A’s EEROM used to store its serial communication 
settings has a finite lifetime of approximately 10,000 write cycles. Even if 
your application program sent the DIAG:COMM:SER[n]:STORe command 
once every day, the lifetime of the EEROM would still be over 27 years. Be 
careful that your application program sends the 
DIAG:COMM:SER[n]:STORe command to an Keysight E1324A no more 
often than is necessary. 

- Related Commands: All SYST:COMM:SER[n]? commands. 

Example 

Store the Serial Communications Settings in the Third Keysight E1324A 
DIAG:COMM:SER3:STOR 
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:DOWN[oad:CHECked[:MADDress] 

DIAGnostic:DOWN[oad:CHECked[:MADDress] <address>,<data> writes data 
into a non-volatile user RAM segment starting at address using error correction. 
The user RAM segment is allocated by the DIAG:NRAM:CREate or 
DIAG:DRAM:CREate command. 

Parameters 


Parameter 

Name 

Parameter Type 

Range of Values 

Default 

Units 

<address> 

numeric 

0 to 16,777,215 (#HFFFFFE) 

none 

<data> 

arbitrary block 
program data 

See “Parameter Types” 

none 


Comments 

- This command is typically used to send a block of data to a block of user 
RAM. It is the only way to send binary data to multiple addresses over a 
serial (RS232C) line. 

- CAUTION: Be certain that all of the data you download will be contained 
entirely within the allocated NRAM segment. Writing data outside of the 
NRAM segment will disrupt the operation of the command module. Most 
computers terminate an OUTPUT, PRINT, or WRITE statement with a 
carriage return or carriage return and linefeed. These End-Of-Line 
characters must be either accounted for (NRAM segment sized to 
accommodate them), or suppressed using an appropriate IMAGE or 
FORMAT statement. Listed below are some helpful methods: 

— Size the NRAM segment a little larger than the expected data block. 

— Control the End-Of-Line characters with format statements. 

— Use the Definite Length Arbitrary Block Program Data format to send 
your data rather than the Indefinite Length Arbitrary Block Program 
Data format. 

- <address> may be specified in decimal, hex (#H), octal (#0), or binary (#B) 
formats. DOWNload is done by word (16-bit) access so address must be 
even. 

- Be certain that address specifies a location within the user RAM segment 
allocated using DIAG:NRAM:CREate if you are downloading a 
configuration table. DIAG:DOWNload can change the contents of System 
RAM, causing unpredictable results. 

- This command can also be used to write data to a device with registers in 
the A16 address space. See DIAGnostic:DOWNload:SADDress. 
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- Related Commands: DIAG:NRAM:CREate, DIAG:NRAM:ADDRess?, 
DIAG:UPLoad[:MADDress]?, VXI:CONF:CTABle, VXI:CONF:DCTable, 
VXI:CONF:ITABle, VXI:CONF:MTABle 

Byte Format 

Each byte sent with this command is expected to be in the following format: 


Bit# 

7 

6 

5 

4 

3 

2 

1 

0 


Control Bit 

Check Bits 

Data Bits 


- Control Bit is used to indicate the serial driver information such as clear, 
reset, or end of transmission. This bit is ignored by the regular 488.2 driver. 
The control bit should be one for regular data. 

- Check Bits are used to detect and correct a single bit error. The control bit 
is not included in the check. The check bits are a Hamming single bit error 
correction code, as specified by the following table: 


Data Value 

Check Bits 

0 

0 

1 

7 

2 

6 

3 

1 

4 

5 

5 

2 

6 

3 

7 

4 

8 

3 

9 

4 

10 

5 

11 

2 

12 

6 

13 

1 

14 

0 

15 

7 


- Data Bits are the actual data being transferred (four bits at a time). Each 
word to be written requires four data bytes for transmission. The 
significance of the data is dependent on the order received. The first data 
byte received contains the most significant nibble of the 16-bit word to be 
written (bits 15-12). 
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The next data byte received contains the least significant nibble of the 
most significant byte of the word (bits 11-8). The third data byte received 
contains the most significant nibble of the least significant byte of the word 
(bits 7-4). The fourth data byte received contains the least significant 
nibble of the least significant byte of the word to be written (bits 3-0). Once 
all four bytes have been received the word will be written. 

:DOWN[oad:CHECked:SADDress 

DIAGnostic:DOWNload:CHECked:SADDress <address>,<data> writes data to 
Non-volatile user RAM at a single address specified by address using error 
correction. It can also write to devices with registers in the A16 address space. 

Parameters 


Parameter 

Name 

Parameter Type 

Range of Values 

Default 

Units 

<address> 

numeric 

0 to 16,777,215 (#HFFFFFE) 

none 

<data> 

arbitrary block 
program data 

See “Parameter Types” 

none 


Comments 

- This command is typically used to send data to a device which accepts 
data at a single address. It is the only way to send binary data to single 
addresses over a serial (RS232C) line. 

- Most computers terminate an OUTPUT, PRINT, or WRITE statement with a 
carriage return or carriage return and linefeed. These End-Of-Line 
characters must be either accounted for (NRAM segment sized to 
accommodate them), or suppressed using an appropriate IMAGE or 
FORMAT statement. Listed below are some helpful methods: 

— Gontrol the End-Of-Line characters with format statements. 

— Use the Definite Length Arbitrary Block Program Data format to send 
your data rather than the Indefinite Length Arbitrary Block Program 
Data format. 

- A register address in A16 address space can be determined by: 

1 FGOOOl 6 + (LADDR * 64) + register_number 

Where 1 FGOOOl 6 is the base address in the command module A16 space, 
LADDR is the device logical address, 64 is the number of address bytes per 
device, and register_number is the register to which the data is written. 
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If the device is an A24 device, the address can be determined using the 
VXI:CONFigure:DLISt? command to find the base address in A24, and then 
adding the register_number to that value. A24 memory between address 
20000016 and address EOOOOOl 6 is directly addressable by the command 
module. 

- <address> may be specified in decimal, hex (#H), octal (#Q), or binary (#B) 
formats. DOWNIoad is done by word (16-bit) access so address must be 
even. 

- Related Commands: DIAG:UPLoad:SADDress? 

Byte Format 

Each byte sent with this command is expected to be in the following format: 


Bit# 

7 

6 

5 

4 

3 

2 

1 

0 


Control Bit 

Check Bits 

Data Bits 


— Control Bit is used to indicate the serial driver information such as clear, 
reset, or end of transmission. This bit is ignored by the regular 488.2 
driver. The control bit should be one for regular data. 

— Check Bits are used to detect and correct a single bit error. The control 
bit is not included in the check. The check bits are a Hamming single bit 
error correction code, as specified by the following table: 


Data Value 

Check Bits 

0 

0 

1 

7 

2 

6 

3 

1 

4 

5 

5 

2 

6 

3 

7 

4 

8 

3 

9 

4 

10 

5 

11 

2 

12 

6 

13 

1 

14 

0 

15 

7 
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— Data Bits are the actual data being transferred (four bits at atime). Each 
word to be written requires four data bytes for transmission. The 
significance of the data is dependent on the order received. The first 
data byte received contains the most significant nibble of the 16-bit 
word to be written (bits 15-12). 

The next data byte received contains the least significant nibble of the 
most significant byte of the word (bits 11-8). The third data byte received 
contains the most significant nibble of the least significant byte of the word 
(bits 7-4). The fourth data byte received contains the least significant 
nibble of the least significant byte of the word to be written (bits 3-0). Once 
all four bytes have been received the word will be written. 
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:DOWN[oad[:MADDress] 

DIAGnostic:DOWN[oad[:MADDress] <address>,<data> writes data into a 
Non-voiatiie user RAM segment starting at address. The user RAM segment is 
allocated by the DIAG:NRAM:CREate command. 

Parameters 


Parameter 

Name 

Parameter Type 

Range of Values 

Default 

Units 

<address> 

numeric 

0 to 16,777,215 (#HFFFFFE) 

none 

<data> 

arbitrary block 
program data 

See “Parameter Types” 

none 


Comments 

- CAUTION: Be certain that all of the data you download will be contained 
entirely within the allocated NRAM segment. Writing data outside of the 
NRAM segment will disrupt the operation of the command module. Most 
computers terminate an OUTPUT, PRINT, or WRITE statement with a 
carriage return or carriage return and line feed. These End-Of-Line 
characters must be either accounted for (NRAM segment sized to 
accommodate them), or suppressed using an appropriate IMAGE or 
FORMAT statement. Some helpful methods: 

— Size the N RAM segment a little larger than the expected data block. 

— Control the End-Of-Line characters with format statements. 

— Use the Definite Length Arbitrary Block Program Data format to send 
your data rather than the Indefinite Length Arbitrary Block Program 
Data format. 

- This command is generally used to download data into User Configuration 
Tables. These tables allow the user to control the system’s dynamic 
configuration, interrupt line allocations, commander/servant hierarchy, 
address space allocation, and mainframe extender configurations. 

- <address> may be specified in decimal, hex (#H), octal (#0), or binary (#B) 
formats. DOWNload is done by word (16-bit) access so address must be 
even. 

- Be certain that address specifies a location within the user RAM segment 
allocated using DIAG:NRAM:CREate if you are downloading a 
configuration table. DIAG:DOWNload can change the contents of System 
RAM, causing unpredictable results. 

- This command can also be used to write data to a device with registers in 
the A16 address space. See DIAGnostic:DOWNload:SADDress. 
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- Related Commands: DIAG:NRAM:CREate, DIAG:NRAM:ADDRess?, 
DIAG:UPLoad[:MADDress]?, VXI:CONF:CTABle, VXI:CONF:DCTable, 
VXI:CONF:ITABle, VXI:CONF:MTABle 

Example 

Load Dynamic Configuration Information into an Allocated RAM Segment 

DIAG:NRAM:CRE 6 Allocate a segment of user RAM. 

DIAG:BOOT:WARM Reboot system to complete allocation. 

DIAG:NRAM:ADDR? Query starting address, enter value to variable X 
Get starting address into X. 

DIAG:DOWN <value of X>,table data Download table data. 

VXI:CONF:DCTAB <value of X> Link configuration table to configuration 

algorithm. 

DIAG:BOOT:WARM Reboot to set new configuration. 

: DOWN load :SAD Dress 

DIAGnostic:DOWNload:SADDress <address>,<data> writes data to Non-volatile 
user RAM at a single address specified by address, and writes data to devices 
with registers in A16 address space. 

Parameters 


Parameter 

Name 

Parameter Type 

Range of Values 

Default 

Units 

<address> 

numeric 

0 to 16,777,215 (#HFFFFFE) 

none 

<data> 

arbitrary block 
program data 

See “Parameter Types” 

none 


Comments 

- Most computers terminate an OUTPUT, PRINT, or WRITE statement with a 
carriage return or carriage return and linefeed. These End-Of-Line 
characters must be accounted for or suppressed using an appropriate 
IMAGE or FORMAT statement. Some helpful methods: 

— Control the End-Of-Line characters with format statements. 

— Use the Definite Length Arbitrary Block Program Data format to send 
your data rather than the Indefinite Length Arbitrary Block Program 
Data format. 
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- A register address in A16 address space can be determined by: 

1 FC00016 + (LADDR * 64) + register_number 

where 1 FCOOOl 6 is the base address in the command module A16 address 
space, LADDR is the device logical address, 64 is the number of address 
bytes per device, and register_number is the register to which the data is 
written. 

If the device is an A24 device, the address can be determined using the 
VXI:CONF:DLISt? command to find the base address in A24, and then 
adding the register_number to that value. A24 memory between address 
20000016 and address E0000016 is directly addressable by the command 
module. 

- <address> may be specified in decimal, hex (#FI), octal (#Q), or binary (#B) 
formats. DOWNload is done by word (16-bit) access so address must be 
even. 

- Related Commands: DIAG:UPLoad:SADDress? 

Example 

Download Data to a Single Address Location 

This program downloads an array with the data 1, 2, 3, 4, 5 to register 32 on a 
device with logical address 40 in VXIbus A16 address space. 

DIM Dnld_data(l :5) Dimension controUer array. 

DATA1,2,3,4,5 

READ Dnld_data(*) Load data into oontroUer array. 

OUTPUT "DIAG:DOWN:SADD #H1 FCA20,#210"; 

This tine is sent without termination. 

Send Dnld_data as 16-bit words Terminate after last word with EOl 

or LF and EOl. 
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:DRAM:AVAi[ab[e? 

DIAGnostic:DRAM:AVAi[ab[e? returns the amount of RAM remaining (available) in 
the DRAM (Driver RAM) segment, which is the amount of RAM in the segment 
minus any previously loaded drivers. 

Comments 

- DIAG:DRAM:CREate does not allocate the RAM segment until after a 
subsequent re-boot. 

- Related Commands: DIAG:DRAM:CREate, DIAG:DRIVer:LOAD, 
DIAG:DRIVer:LIST[:ALL]? 

Example 

Determine Amount of Space Left for Drivers in the DRAM Segment 
DIAG:DRAM:AVA? 

enter statement Statement returns available DRAM in bytes. 


:DRAM:CREate 

DIAGnostic:DRAM:CREate <size>,<num_drivers> creates a Non-volatile RAM 
area for loading instrument drivers. DIAG:DRAM:CREate 0 removes the RAM 
segment when the system is rebooted. 

Parameters 


Parameter 

Name 

Parameter Type 

Range of Values 

Default 

Units 

<size> 

numeric 

0 to available RAM or MIN | MAX 

none 

<num_drivers> 

numeric 

0 to available RAM or 

MINI MAX |DEF 

none 


Comments 

- <size> is the number of bytes to be allocated to DRAM use. A size of zero 
will remove the DRAM segment. 

- <num_drivers> is the maximum number of drivers to be loaded. 

- The DRAM segment will be created only after the System instrument has 
been rebooted (cycle power or execute DIAG:BOOT). 

- Based on the size specified, DIAG:DRAM:CRE rounds the size up to an even 
value. 

- DRAM will de-allocate previously allocated NRAM and RDISk segments. 
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- Using all of the available RAM (MAX) forthe DRAM segment will limit some 
functions such as IBASIC program space, instrument reading storage 
space, and full functionality of the display terminal interface. 

- Use DIAG:DRIVer:LOAD... and DIAG:DRIVer:LIST...? to load and manage 
DRAM. 

- Related Commands: DIAG:DRAM:AVAilable?, DIAG:DRIVer:LOAD..., 
DIAG:DRIVer:LIST...? 

Example 

Allocate a 15 Kbyte Non-Volatile Driver RAM Segment 

DIAG:DRAM:CRE 15360 Allocate 15 Kbyte segment of driver RAM. 

:DRAM:CREate? 

DIAGnostic:DRAM:CREate? [<MIN | MAX>,<MIN | MAX | DEF>] returns the size 
(in bytes) of a previously created Non-volatile RAM area for loading instrument 
drivers, and the number of drivers currently loaded. 

Comments 

- If you specify one of the parameters, you must specify both. 

iDRIVerlNSTaii 

DIAGnostic:DRIVer:INSTall makes the drivers downloaded to Flash ROM 
available (installs them) by creating the driver index table. 

Comments 

- You cannot download any additional drivers into Flash ROM after you have 
executed this command. To download any new drivers you must recreate 
the Flash ROM driver area with the DIAG:FROM:CREate command. This 
will erase any drivers you have already downloaded, which will then have 
to be reloaded. 

- Related Commands: DIAG:FROM:CREate 
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:DRIVer:LIST[:type]? 

- DIAGnostic:DRIVer:LIST[:type]? lists all drivers from the specified table 
found on the system. If no parameter is specified, all driver tables are 
searched and the data from each driver table is separated from the others 
by a semicolon. 

Parameters 


Parameter 

Name 

Parameter 

Type 

Range of Values 

Default 

Units 

[:type] 

discrete 

ALL 1 RAM 1 ROM 1 FROM 

ALL 


For each driver listed, the system returns NAME, IDN_MODEL, REV_CODE, and 
TABLE. 


Parameter 

Description 

NAME 

The instrument name. This is the same label that appears on the 
instrument selection menu. 

IDN_MODEL 

The model name. This is the same model name as used in the response 
to the *IDN? command. 

REV_CODE 

The revision code. It is in the form A.nn.nn. A is an alpha character. 

TABLE 

The name ofthe table the driver was found in. This will be RAM, ROM, or 
FROM. 


Comments 


- DIAGnostic:DRIVer:LIST? lists all drivers found in the system. 

- DIAGnostic:DRIVer:LIST:FROM? lists all drivers found in the Flash ROM 
driver table. 

- DIAGnostic:DRIVer:LIST:RAM? lists all drivers found in the RAM driver 
table DRAM. 

- DIAGnostic:DRIVer:LIST:ROM? lists all drivers found in the ROM driver 
table. 

- Related Commands: DIAG:DRAM:AVAilable?, DIAG:DRAM:CREate, 
DIAG:DRIVer:LOAD... 

Example 

List All Drivers in the System 

DIAG:DRIV:LIST? Lists all drivers currently loaded. 
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Example 

List All Drivers in ROM 

DIAG:DRIV:LIST:ROM? Lists ail of the drivers in ROM. 


:DRIVer:LOAD 

DIAGnostic:DRIVer:LOAD <driver_block> loads the instrument driver contained 
in the driver_block into a previously created DRAM segment. 

Parameters 


Parameter 

Name 

Parameter Type 

Range of Values 

Default 

Units 

<driver_b[ock> 

arbitrary block 
program data 

See “Parameter Types” 

none 


Comments 

- driver_block is the actual binary driver data to be transferred. 

- Related Gommands: DIAG:DRAM:AVAilable?, DIAG:DRAM:GREate, 
DIAG:DRIVer:LIST...? 

Example 

Download a Driver Block 

DIAG:DRIV:LOAD <driver_block> Downloads the driver <driver_blook> 

to DRAM memory or to Flash ROM. 


:DRIVer:LOAD iCHECked 

DIAGnostic:DRIVer:LOAD:GHEGked <driver_block> loads the instrument driver 
contained in the driver_block into a previously created DRAM segment. The 
driver_block is formatted in the same data byte format used by 
DIAG:DOWNload:GHEGked. 

Parameters 


Parameter 

Name 

Parameter Type 

Range of Values 

Default 

Units 

<driver_block> 

arbitrary block 
program data 

See “Parameter Types” 

none 
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Comments 

- <driver_b[ock> is the actual binary driver data to be transferred. 

- This is the only way to download a device driver over a serial (RS-232) line. 

- Related Commands: DIAG:DRAM:AVAilable?, DIAG:DRAM:CREate, 
DIAG:DRIVer:LIST...? 

Example 

Download a Driver Named Over RS-232 

DIAG:DRIV:LOAD:CHEC <checked_driver_block> 

Downloads the <oheoked_driver_biook> to DRAM 
memory or Flash ROM. 


iFROMiAVAiiabie? 

DIAGnostic:FROM:AVAilable? returns the amount of Flash ROM remaining to 
hold new device drivers. This is the amount of Flash ROM in the segment minus 
any previously loaded drivers and overhead. 

Comments 

- DIAG:FROM:AVAilable? returns zero if you have not created a valid flash 
driver area using DIAG:FROM:CREate while the system is in “ LOAD” mode. 

- Related Commands: DIAG:FROM:CREate (LOAD mode command only), 
DIAG:FROM:SIZE?, DIAG:DRIVer:LOAD, DIAG:DRIVer:LIST[:ALL]? 

Example 

Determine Amount of Space Left for Drivers in the Flash ROM Segment 
DIAG:FROM:AVA? 

enter statement Statement returns available Flash ROM in bytes. 
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:FROM:CREate 

DIAGnostic:FROM:CREate <num_drivers> creates a driver area in Flash ROM for 
loading instrument drivers. DIAGnostic:FROM:CREate 0 removes the Flash ROM 
driver area, but does not affect the operating system program that is also in Flash 
ROM. 

Parameters 


Parameter 

Name 

Parameter Type 

Range of Values 

Default 

Units 

<num_drivers> 

numeric 

Oto 64 

none 


Comments 

- <num_drivers> is the maximum number of drivers to be loaded into Flash 
ROM. 

- Use DIAG:DRIVer:LOAD... to load drivers into Flash ROM when the Flash 
ROMS Run/Load switch is in the "Load" position. 

- Related Commands: DIAG:FROM:AVAilable?, DIAG:DRIVer:LOAD? , 
DIAG:DRIVer:LIST? 

Example 

Initialize a Flash ROM Driver Segment for a Maximum of 8 Drivers 
DIAG:FROM:CRE 8 

:FROM:CREate? 

DIAGnostic:FROM:CREate? returns the maximum number of drivers that a Flash 
ROM segment was created with. 

Comments 

- Related Commands: DIAG:FROM:CREate (LOAD mode command only). 

Example 

Determine Maximum Number of Drivers from a Flash ROM Segment 
DIAG:FROM:CRE? 

enter statement Statement returns maximum number of 
Flash ROM drivers. 


166 


Keysight E1406A User Manual and SCPI Programing Guide 




DIAGnostic Subsystem 


Keysight El 406A Command Reference 


:FROM:SIZE? 

DIAGnostic:FROM:SIZE? returns the amount of Flash ROM available to be used 
as Flash ROM driver area. This command does not take into account the size of 
the driver index table, checksum field, and so forth. 

Comments 

- Related Commands: DIAG:FROM:CREate (LOAD mode command only), 
DIAG:FROM:AVAilable?, DIAG:DRIVer:LOAD, DIAG:DRIVer:LIST[:ALL]? 

Example 

Determine Amount of Space Left for Drivers in the Flash ROM Segment 
DIAG:FROM:SIZE? 

enter statement Statement returns space available for FROM in bytes. 


:INTerrupt:ACTivate 

DIAGnostic:INTerrupt:ACTivate <mode> enables an interrupt on the VXI 
backplane interrupt line specified by DIAG:INTerrupt:SETup[n] to be 
acknowledged. 

Parameters 


Parameter 

Name 

Parameter Type 

Range of Values 

Default 

Units 

<mode> 

boolean 

0|1 |0FF|0N 

none 


Comments 

- When an interrupt occurs and has been acknowledged, the response is 
read with the DIAG:INTerrupt:RESPonse? command. 

- If an Interrupt occurs on a VXIbus backplane Interrupt line and the 
interrupt acknowledgment has not been enabled, there is no interrupt 
acknowledgment response. The interrupt will be held off until the interrupt 
acknowledge is enabled by either the DIAG:INT:ACTivate command or 
DIAG:INT:RESPonse? command. 

- ON or 1 enables interrupt acknowledgment. OFF or 0 disables interrupt 
acknowledgment. 

- In order for an Interrupt to be serviced using the DIAG:INT commands, the 
interrupt line [n] must be assigned to an interrupt handler using the 
interrupt line allocation table covered in Chapter 2. 
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- Bit 8 in the Operation Status Register can be used to indicate when an 
interrupt has been acknowledged (see Chapter 4 for details). 

- Related Commands: DIAG:INTerrupt:PRIority[n], 
DIAG:INTerrupt:RESPonse?, DIAG:INTerrupt:SETup[n] 

- *RST Condition: DIAG:INTerrupt:ACTivate OFF (for all lines). 

- Interrupt acknowledgment must be re-enabled each time an interrupt is 
acknowledged. 

Example 

Enable an Interrupt Acknowledgment on Line 2 

DIAG:INT:SET2 Set up interrupt line 2. 

DIAG:INT:ACT ON Enable interrupt acknowledged. 

:INTerrupt:PRIority[n] 

DIAGnostic:INTerrupt:PRIority[n] <level> gives a priority level to the VXI interrupt 

line specified by [n]. 


Parameter 

Name 

Parameter Type 

Range of Values 

Default 

Units 

[n] 

numeric 

1 through 7 

1 

< level > 

numeric 

1-7 1 MINI MAX|DEF 

none 


Comments 

- The priority of an interrupt line determines which line will be 
acknowledged first when more than one line is interrupting. 

- For level, lower values have lower priority (level 1 is a lower priority than 
level 2). 

- No parameter, or DEE (default) sets priority to 1. 

- PRIorityl through PRIority? specifies the VXI interrupt lines 1 through 7. 

- Sending PRIority without an [n] value specifies VXI interrupt line 1. 

- In order for an interrupt to be serviced using the DIAGnostic:INTerrupt 
commands, the interrupt line [n] must be assigned to an interrupt handler 
using the interrupt line allocation table. 

- This command has no effect if only one interrupt line is to be set up. 

- Related Commands: DIAG:INTerrupt:ACTivate, DIAG:INTerrupt:SETup[n], 
DIAG:INTerrupt:RESPonse? 
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Example 

Setup, Set a Priority, and Wait for VXI Interrupt Response on Line 2 

DIAG:INT:SET2 ON Handle interrupt on line 2. 

DIAG:INT:PRI2 5 Set priority to 5 on line 2 oode whioh will initiate 

an aotion resulting in an interrupt. 

DIAG:INT:RESP? Read the aoknowledge response. 

:INTerrupt:PRIority[n]? 

DIAGnostic:INTerrupt:PRIority[n]? returns the current priority level set for the VXI 
interrupt line specified by [n]. 

Comments 

- PRIorityl? through PRIority?? specifies the VXI interrupt lines 1 through 7. 

- Sending PRIority? without an [n] value specifies VXI interrupt line 1. 

- Related Commands: DIAG:INTerrupt:PRIority[n], DIAG:INTerrupt:SETup[n], 
DIAG:INTerrupt:RESPonse? 

Example 

Determine Interrupt Priority for Line 4 
DIAG:INT:PRI4? 

enter statement Statement returns 7 through 7. 


:INTerrupt:RESPonse? 

DIAGnostic:INTerrupt:RESPonse? returns the interrupt acknowledge response 

(STATUS/ID word) from the highest priority VXI interrupt line. 

Comments 

- The value returned is the response from the interrupt acknowledge cycle 
(STATUS/ID word) of a device interrupting on one of the interrupt lines set 
up with the DIAG:INT:SETup[n] command. 

- Bits 0 through 7 of the STATUS/ID word are the interrupting device’s 
logical address. Bits 8 through 15 are Cause/Status bits. Bits 16 through 
31 (D32 Extension) are not read by the System instrument. 

- If only bits 0 through 7 are used by the device (bits 8 -15 are FF), the 
logical address can be determined by adding 256 to the value returned by 
DIAG:INT:RESPonse?. If bits 0 -15 are used, the logical address is 
determined by adding 65,536 to the value returned (if the number returned 
is negative). 
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- Only the interrupt lines previously configured with the DIAG:INT:SETup[n] 
commands generate responses for this command. 

- If there are interrupts on multiple lines when this command is received, or 
when the acknowledgment was enabled with DIAG:INT:ACTivate, the 
response data returned will be from the line with the highest priority set 
using the DIAG:INT:PRIority[n] command. 

- If Interrupt acknowledge has not been enabled with DIAG:INT:AGTivate, 
then it will be enabled by DIAG:INT:RESPonse?. System instrument 
execution is halted until the interrupt acknowledgment response is 
received. 

- DIAG:INT:WAIT? can also be used to wait for the interrupt response. 

- Related Gommands: DIAG:INTerrupt:AGTivate, DIAG:INTerrupt:SETup[n], 
DIAG:INTerrupt:PRIority[n] 

Example 

Setup and Wait for VXI Interrupt Response on Line 2 

DIAG:INT:PRI2 5 Set priority to 5 on line 2. 

DIAG:INT:SET2 GN Handle interrupt on line 2.Code whioh will initiate 
an aotion resulting in an interrupt. 

DIAG:INT:RESP? Read the aoknowledge response. 

:INTerrupt:SETup[n] 

DIAGnostic:INTerrupt:SETup[n] <mode> specifies that an interrupt on VXI 
backplane interrupt line [n] will be serviced by the System instrument service 
routine (DIAGnostic:INTerrupt commands) rather than the operating system 
service routine. 

Parameters 


Parameter 

Name 

Parameter Type 

Range of Values 

Default 

Units 

[n] 

numeric 

1 through 7 

1 

<mode> 

boolean 

0|1 |0FF|0N 

none 


Comments 

- SETupl through SETup7 specifies the VXI Interrupt lines 1 through 7. 

- Sending SETup without an [n] value specifies VXI interrupt line 1. 
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- ON or 1 specifies that interrupt handling is to be set up for the specified 
interrupt line. OFF or 0 indicates that interrupt handling of the specified 
line is to be done by the operating system. 

- In order for an interrupt to be serviced using the DIAG:INT commands, the 
interrupt line [n] must be assigned to an interrupt handler using the 
interrupt line allocation table covered in Ohapter 2. 

- Related Oommands: DIAG:INTerrupt:AOTivate, DIAG:INTerrupt:PRIority[n], 
DIAG:INTerrupt:RESPonse? 

- *RST Gondition: DIAG:INTerrupt:SETup OFF (for all lines). 

Example 

Setup and Wait for VXI Interrupt Response on Line 2 

DI AG: I NT: PR 12 5 Set priority to 5 on line 2. 

DIAG:INT:SET2 ON Handle interrupt on line 2 oode whioh will 

initiate an aotion resulting in an interrupt. 

DIAG:INT:RESP? Read the aoknowledge response. 

:INTerrupt:SETup[n]? 

DIAGnostic:INTerrupt:SETup[n]? returns the current state set by 
DIAG:INTerrupt:SETup[n] <mode>, for the VXI interrupt line specified by [n] in ... 
SETup[n]?. 

Parameters 


Parameter 

Name 

Parameter Type 

Range of Values 

Default 

Units 

[n] 

numeric 

1 through 7 

1 


Comments 

- SETupl? through SETup7? specifies the VXI interrupt lines 1 through 7. 

- Sending SETup? without an [n] value specifies VXI Interrupt line 1. 

- If 1 is returned, interrupt handling is set up for the specified interrupt line 
using the System instrument (DIAG:INT ...commands). If 0 is returned, 
interrupt handling is done by the operating system. 

- Related Gommands: DIAG:INTerrupt:SETup[n], DIAG:INTerrupt:PRIority[n], 
DIAG:INTerrupt:AGTivate, DIAG:INTerrupt:RESPonse? 
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Example 

Determine Interrupt Setup for Line 4 
DIAG:INT:SET4? 

enter statement Statement returns 0 or 1. 


:NRAM:ADDRess? 

DIAGnostic:NRAM:ADDRess? returns the starting address of theNon-volatile 
user RAM segment allocated using DIAG:NRAM:CREate. 

Comments 

- DIAG:NRAM:CREate does not allocate the RAM segment until after a 
subsequent reboot. To get accurate results, execute 
DIAG:NRAM:ADDRess? after the reboot. 

- Related Commands: DIAG:NRAM:CREate, DIAG:NRAM:CREate?, 
DIAG:DOWNload, DIAG:UPLoad? 

Example 

Determine Address of the Most Recently Created User RAM Segment 
DIAG:NRAM:ADDR? 

enter statement Statement returns decimal numeric address. 


:NRAM:CREate 

DIAGnostic:NRAM:CREate <size> allocates a segment of Non-volatile user RAM 
for a user-defined table. 

Parameters 


Parameter 

Name 

Parameter Type 

Range of Values 

Default 

Units 

<size> 

numeric 

0 to available RAM or MIN | MAX 

none 


Comments 

- The RAM segment will be created only after the System instrument has 
been rebooted (cycle power or execute DIAG:BOOT). 

- Based on the size specified, DIAG:NRAM:CREate rounds the size up to an 
even value. 

- NRAM will de-allocate a previously allocated RDISk segment. 
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- Using all of the available RAM (MAX) forthe NRAM segment will limit some 
functions such as IBASIC program space, instrument reading storage 
space, and full functionality of the display terminal interface. 

- Use DIAG:NRAM:ADDRess? to determine the starting address of the RAM 
segment. 

- Use DIAG:DOWNload, DIAG:UPLoad?, DIAG:PEEK, or DIAG:POKE to store 
and retrieve information in the Non-volatile RAM segment. 

- Use DIAG:NRAM:CREate? MAX to find maximum available segment size. 

- Related Commands: DIAG:NRAM:CREate?, DIAG:NRAM:ADDRess?, 
DIAG:DOWNload, DIAG:UPLoad? 

Example 

Allocate a 15 Kbyte User Non-Volatile RAM Segment 

DIAG:NRAM:CREate 15360 Allocate 15 Kbyte segment of user RAM. 

:NRAM:CREate? 

DIAGnostic:NRAM:CREate? [MIN | MAX] returns the current or allowable (MIN | 

MAX) size of the user Non-volatile RAM segment. 

Comments 

- DIAG:NRAM:CREate does not allocate driver RAM until a subsequent 
reboot. To get accurate results, execute DIAG:NRAM:CREate? after the 
reboot. 

- Related Commands: DIAG:NRAM:ADDRess?, DIAG:NRAM:CREate 

Example 

Check the Size of the User RAM Segment 
DIAG:NRAM:CREate? 

enter statement Statement enters size in bytes. 
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:PEEK? 


DIAGnostic:PEEK? <address>,<width> reads the data (number of bits given by 
width) starting at address. 

Parameters 


Parameter 

Name 

Parameter Type 

Range of Values 

Default 

Units 

<address> 

numeric 

0 to 16,777,215 (#HFFFFFF) 

none 

<width> 

numeric 

8|16|32 

none 


Comments 


- <address> specifies a location within the range of the control processor’s 
addressing capability. 

- <address> may be specified in decimal, hex (#H), octal (#Q), or binary (#B) 
formats. 

- Related Commands: DIAG:POKE 

Example 

Read Byte from User Non-Volatile RAM 

DIAG:PEEK? 16252928,8 Ask for byte. 

enter statement Return value of byte. 


:POKE 


DIAGnostic:POKE <address>,<width>,<data> writes data (number of bits given 
by width) starting at address. 

Parameters 


Parameter 

Name 

Parameter Type 

Range of Values 

Default 

Units 

<address> 

numeric 

0 to 16,777,215 (#HFFFFFF) 

none 

<width> 

numeric 

8|16|32 

none 

<data> 

numeric 

8 to 32-bit integer 

none 
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Comments 

- <address> specifies a location within the range of the control processor’s 
addressing capability. 

- <address> and <data> may be specified in decimal, hex (#H), octal (#Q), or 
binary (#B) formats. 

- CAUTION: DIAG:POKE can change the contents of any address in RAM. 
Changing the contents of RAM used by the command module’s control 
processor can cause unpredictable results. 

- Related Commands: DIAG:PEEK? 

Example 

Store Byte in User Non-Volatile RAM 
DIAG:POKE 16252928,8,255 

:RDISk:ADDress? 

DIAGnostic:RDISk:ADDRess? returns the starting address of the RAM disc 
volume previously defined with the DIAG:RDISk:CREate command. The RAM disc 
volume is defined for use only by the IBASIC option. 

Comments 

DIAG:RDISk:CREate does not allocate the RAM volume segment until after a 
subsequent reboot. To get accurate results, execute DIAG:RDISk:ADDRress? 
after the reboot. 

Related Commands: DIAG:RDISk:CREate, DIAG:RDISk:CREate? 

Example 

Return the Starting Address of the IBASIC RAM Volume 
DIAG:RDIS:ADDR? 

enter statement Statement returns decimal numeric address. 
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:RDISk:CREate 

DIAGnostic:RDISk:CREate <size> allocates memory for a RAM disc volume. The 
RAM disc volume is defined for use only by the IBASIC option. 

Parameters 


Parameter 

Name 

Parameter Type 

Range of Values 

Default 

Units 

<size> 

numeric 

0 to available RAM or MIN | MAX 

none 


Comments 

- The RAM disc segment will only be created after the System instrument 
has been rebooted (cycle power or execute DIAG:BOOT). 

- Using all of the available RAM (MAX) for the disc volume segment will limit 
some functions such as IBASIC program space, instrument reading storage 
space, and full functionality of the display terminal interface. 

- Related Commands: DIAG:RDISk:ADDRess?, DIAG:RDISk:CREate? 

Example 

Allocate a 64 Kbyte Segment for the IBASIC Option’s RAM Volume 
DIAG:RDIS:CRE 65536 

:RDISk:CREate? 

DIAGnostic:RDISk:CREate? [MIN | MAX] returns the current or allowable (MIN | 

MAX) size of the RAM disc volume segment. 

Comments 

- DIAG:RDISk:CREate does not allocate driver RAM until a subsequent 
reboot. To get accurate results, execute DIAG:RDISk:CREate? after the 
reboot. 

- Related Commands: DIAG:RDISk:CREate, DIAG:RDISk:ADDRess? 

Example 

Return the Size of the Current RAM Disc Volume 
DIAG:RDIS:CRE? 

enter statement Returns numeric size. 
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:UPLoad[:MADDress]? 

DIAGnostic:UPLoad[:MADDress]? <address>,<byte_count> returns the number 
of bytes specified by byte_count, starting at address. 

Parameters 


Parameter 

Name 

Parameter Type 

Range of Values 

Default 

Units 

<address> 

numeric 

0 to 16,777,215 (#HFFFFFE) 

none 

<byte_count> 

numeric 

0 to (999,999,998) 

none 


Comments 

- <address> may be specified in decimal, hex (#H), octal (#Q), or binary (#B) 
formats. 

- UPLoad is done by word (16-bit) access so address and byte_count must 
be even. 

- Data is returned in the Definite Block Response Data format: 

#<non-zero digit><digit(s)><data byte(s)> 

Where the value of <non-zero digit> equals the number of <digit(s)>. The 
value of <digit(s)> taken as a decimal integer indicates the number of 
<data byte(s)> to expect in the block. 

- This command can also be used to retrieve data from a device with 
registers in A16 address space. See DIAGnostic:UPLoad:SADDress? 

- Related Commands: DlAG:NRAM:ADDress?, DIAG:NRAM:CREate, 
DIAG:DOWNload 

Example 

Upload Data Stored on Non-Volatile User RAM 

DIM HEADER$[6],DATA(1024) 6 chars for "#41024" header; 

1,024 chars for data bytes. 

DIAG:NRAM:ADDR? Get starting address ofNRAM. 

enter ADD Address into ADD. 

DIAG:UPL? <value of ADD>,1024 Request 1 Kbyte from address in ADD. 

enter HEADER$ Strip "#41024" from data. 

enter DATA Get 1024 data bytes into the array; use enter format so 
statement will not terminate on GRs or LFs, and so 
forth. Line Feed (LF) and EOl follow the last character 
retrieved. 
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:UPLoad:SADDress? 

DIAGnostic:UPLoad:SADDress? <address>,<byte_count> returns the number of 
bytes specified by byte_count at address. 

Parameters 


Parameter 

Name 

Parameter 

Type 

Range of Values 

Default 

Units 

<address> 

numeric 

0 to 16,777,215 (#HFFFFFE) 

none 

<byte_count> 

numeric 

Oto (999,999,998) 

none 


Comments 

- <address> may be specified in decimal, hex (#H), octal (#Q), or binary (#B) 
formats. 

- UPLoad is done by word (16-bit) access so address and byte_count must 
be even. 

- The register address in A16 address space can be determined by: 

1 FC00016 + (LADDR * 64) + register_number 

Where 1 FCOOOl 6 is the base address in the VXIbus A16 address space, 
LADDR is the device logical address, 64 is the number of address bytes per 
device, and register_number is the register from which data is retrieved. 

If the device is an A24 device, the address can be determined using the 
VXI:CONF:DLISt? command to find the base address in A24, and then 
adding the register_number to that value. A24 memory between address 
20000016 and address EOOOOOl 6 is directly addressable by the command 
module. 

- Data is returned in the Definite Block Response Data format: 

#<non-zero digit><digit(s)><data byte(s)> 

where the value of <non-zero digit> equals the number of <digit(s)>. The 
value of <digit(s)> taken as a decimal integer indicates the number of 
<data byte(s)> to expect in the block. 

- Related Commands: DIAG:DOWNload:SADDress 

Example 

Upload Data Stored in Non-Volatile User RAM 

This program reads 1,024 data bytes from register 32 on a device with logical 
address 40 in command module A16 address space. 
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DIM HEADER$[6],DATA(1024) 6 chars for "#41024" header; 1,024 

chars 

for data bytes. 

DIAG:UPL:SADD? #H1 FCA20,1024 Request 1 Kbyte from device 

register 32. 

enter HEADER$ Strip "#41024" from data. 

enter DATA Get 1,024 data bytes into the array; 

use enter format so statement will not 
terminate on CRs or LFs, and so forth. 
Line Feed (LF) and EOl follow the last 
character retrieved. 
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OUTPut Subsystem 

The OUTPut subsystem controls the output of pulses and levels to the ECLTrg 
and TTLTrg* trigger buses as well as the command module’s front panel Trig Out 
connector. Signals conneoted to the front panel Trig In connector can also 
operate the EOLTrg and TTLTrg* trigger buses. 


NOTE 


The Keysight El 406A Command Module’s TTLTrg trigger lines and 
Trig Out port use "low true" or negative logic. When a trigger level 
is set (for example, OUTPut:EXTernal:LEVel 1), a low voltage is 
present. 


Subsystem Syntax 

OUTPut 

:EOLTrg<n> (:EOLTrgO or :EOLTrgl) 
:IMMediate 
:LEVel 

[:IMMediate] <level> 

[:IMMediate]? 

:SOURce <source> 

:SOURce? [:STATe] <mode> [:STATe]? 
:EXTernal 
:IMMediate 
:LEVel 

[:IMMediate] <level> 

[: IM Mediate]? 

:SOURce <source> 

:SOURce? [:STATe] <mode> [:STATe]? 
:TTLTrg<n> (TTLTrgO through :TTLTrg7) 
:IMMediate 
:LEVel 

[:IMMediate] <level> 

[:IMMediate]? 

:SOURce <source> 

:SOURce? [:STATe] <mode> 

[:STATe]? 
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: EC LTrg < n >: IM Med iate 

OUTPut:ECLTrg<n>:IMMediate causes a pulse to appear on the specified ECL 
Trigger line. 

Comments 

- ECLTrg<n> represents either ECLTrgO or ECLTrgl. 

- OUTPut:ECLTrg<n>:STATe must be ON and OUTPut:ECLTrg<n>:SOURce 
must be set to INT or NONE in order to issue an immediate pulse. A 
"settings conflict" error is generated if :STATe is not ON. 

- Related Oommands: OUTPut:EOLTrg<n>:SOURce, 
OUTPut:EOLTrg<n>[:STATe] 

Example 

Send Trigger Pulse to EOLTrgO 

OUTP:EOLTO:STAT ON Set System instrument to send a pulse on ECLTO. 
OUTP:EOLTO:SOUR INT Set trigger souroe to internal. 

OUTP:EOLTO:IMM Pulse the ECLTrgO bus. 

:ECLTrg<n>:LEVe[ [ilMMediate] 

OUTPut:EOLTrg<n>:LEVel[:IMMediate] <level> sets the selected EOLTrg trigger 
line to logic level 0 or 1. 

Parameters 


Parameter 

Name 

Parameter 

Type 

Range of Values 

Default 

Units 

<n> 

numeric 

Oorl 

N/A 

<[evei> 

boolean 

0|1 |0FF|0N 

none 


Comments 

- OUTP:ECLTrg<n>:STATe must be ON. 

- OUTP:EOLTrg<n>:SOURce must be INTernal. 

- OUTP:EOLTrg<n>:STATe must be ON forthe source to drive the trigger line. 
Setting :STATe OFF does not change the source, so the signal driving the 
line is still present. Setting :STATe back ON sets the source to NONE and 
de-asserts the line. 
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- Related Commands: OUTP:ECLTrg<n>:LEVel[:IMMediate]?, 
OUTP:ECLTrg<n>:SOURce, OUTP:ECLTrg<n>[:STATe] 

- *RST Condition: OUTP:ECLTrg<n>:LEVel 0 


Example 

ECLTrgO Set to Logic Level 1 
OUTP:ECLTO ON 
OUTP:ECLTO:SOUR INT 
OUTP:ECLTO:LEV 1 


Enable ECLTO. 

Set the source to internal. 
Set trigger level. 


:ECLTrg<n>:LEVe[ [ilMMediate]? 

OUTPut:ECLTrg<n>:LEVel[:IMMediate]? returns the current logic level of the 
selected ECLTrg trigger line. 

- ECLTrg<n> represents either ECLTrgO or ECLTrgl. 


Example 

Determine Current State of ECLTrgl 

OUTP:ECLTl:LEV? Ask for level. 

enter statement Return state of trigger line. 


:ECLTrg<n>:SOURce 

OUTPut:ECLTrg<n>:SOURce <source> selects which source will drive the 
selected trigger line. 

Parameters 


Parameter 

Name 

Parameter 

Type 

Range of Values 

Default 

Units 

<n> 

numeric 

Oorl 

N/A 

<source> 

discrete 

INT 1 EXT 1 NONE 

none 


Comments 

- INT allows the selected trigger line to be driven by OLJTP:ECLTrg<n>:LEVel 
commands. 

- EXT allows the selected trigger line to be driven by the Keysight E1406A 
Command Module’s Trig In front panel SMB connector. 
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- OUTP:ECLTrg<n>:STATe must be ON forthe source to drive the trigger line. 
Setting :STATe OFF does not change the source, so the signal driving the 
line is still present. Setting :STATe back ON sets the source to NONE and 
de-asserts the line. 

- Related Oommands: OUTP:EOLTrg<n>[:STATe], 
OUTP:EOLTrg<n>:LEVel[:IMMediate] 

- *RST Oondition: OUTP:EOLTrg<n>:SOURce NONE 

Example 

Select the Trig In Oonnectorto Drive EOLTrgO 
OUTP:EOLTO:SOUR EXT 

:ECLTrg<n>:SOURce? 

OUTPut:EOLTrg<n>:SOURce? queries the source currently driving the selected 
trigger line. 

Comments 

- EOLTrg<n> represents either EOLTrgO or EOLTrgl. 

- Querying the source with :STATe OFF returns NONE, regardless of the 
actual source setting. 

Example 

Determine the Source Driving EOLTrgl 
OUTP:EOLTl:SOUR? 

enter statement Return trigger source. 

:ECLTrg<n>[:STATe] 

OLJTPut:EOLTrg<n>[:STATe] <mode> enables configuration (for example, source 
and level) of the specified trigger line. 

Parameters 


Parameter 

Name 

Parameter 

Type 

Range of Values 

Default 

Units 

<n> 

numeric 

Oorl 

N/A 

<mode> 

boolean 

0|1 |0FF|0N 

none 
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Comments 

- When a trigger line is asserted (OUTP:ECLTrg<n>:LEVe[ 1), it remains 
asserted when :STATe OFF is set. Setting :STATe ON again de-asserts the 
line by setting the source to NONE. 

- Related Oommands: OUTP:EOLTrg<n>:LEVel[:IMMediate], 
OUTP:EOLTrg<n>:SOURce 

- *RST Oondition: OUTP:EOLTrg<n>[:STATe] 0 

Example 

Enable the EOLTrgl Trigger Bus 
OUTP:EOLTl:STATON 

:ECLTrg<n>[:STATe]? 

OUTPut:EOLTrg<n>[:STATe]? returns the current state (ON or OFF) of the selected 
trigger line. 

Oomments 

- EOLTrg<n> represents either EOLTrgO or EOLTrgl. 

Example 

Query the State of EOLTrgl 
OUTP:EOLTl:STAT? 

enter statement Return the current state. 


lEXTernaUMMediate 

OUTPut:EXTernal:IMMediate causes a pulse to appear on the Keysight E1406A 
Oommand Module’s front panel Trig Out SMB port. 

Comments 

- OUTP:EXTernal:STATe must be ON and OUTP:EXTernal:SOURce must be 
INTor NONE. 

- Related Oommands: OUTP:EXTernal[:STATe], OUTP:EXTernal:SOURce 

Example 

Send Trigger Pulse to Trig Out Port 

OUTP:EXT:STAT ON Enable Trig Out port. 

OUTP:EXT:SOUR I NT Set trigger source. 

OUTP:EXT:IMM Pulse Trig Out. 
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:EXTema[:LEVe[[:IMMediate] 

OUTPut:EXTerna[:LEVe[[:IMMediate] <[eve[> sets the Trig Out port to a logic 
level of 0 or 1. 

Parameters 


Parameter 

Name 

Parameter 

Type 

Range of Values 

Default 

Units 

<[eve[> 

boolean 

0|1 |0FF|0N 

none 


Comments 

- OUTP:EXTernal:STATe must be ON. 

- OUTP:EXTernal:SOURce must be iNTernal. 

- Once the level of the Trig Out port is set to logic level 1, it remains set if 
OUTP:EXTernal:STATe OFF is set. Setting OUTP:EXTernal:STATe back to 
ON sets the output back to logic level 0, and sets OUTP:EXTernal:SOURce 
to NONE. 

- Related Oommands: OUTP:EXTernal:LEVel[:iMMediate]?, 
OUTP:EXTernal:SOURce, OUTP:EXTernal[:STATe] 

- *RST Oondition: OUTP:EXTernal:LEVel 0 

Example 

Set Trig Out Port to Logic Level 1 

OUTP:EXT:STATON Enable output. 

OUTP:EXT:SOUR iNT Set trigger source internal. 

OUTP:EXT:LEVl Set output level. 

lEXTernaiiLEVei [ilMMediate]? 

OUTPut:EXTernal:LEVel[:iMMediate]? returns the current logic level of the Trig 
Out port. 

Example 

Determine the Ourrent State of Trig Out Port 

OUTP:EXT:LEV? Ask for level. 

enter statement Return state of trigger bus. 
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:EXTerna[:SOURce 

OUTPut:EXTerna[:SOURce <source> selects which source will drive the Trig Out 
port. 

Parameters 


Parameter 

Name 

Parameter 

Type 

Range of Values 

Default 

Units 

<source> 

discrete 

INT 1 TTLTrg lECLTrgl NONE 

none 


Comments 

- INT allows the Trig Out port to be driven by OUTP:EXTernal:LEVel. 

- TTLTrg or EOLTrg allows the Trig Out port to be driven by the selected 
VXIbus trigger line. 

- OUTP:EXTernal:STATe must be ON for the source to operate the Trig Out 
port. Setting :STATe OFF does not change the source, so the signal driving 
the port is still present. Setting :STATe back ON sets the source to NONE. 

- Related Oommands: OUTP:EXTernal[:STATe], 

OUTP:EXTernal:LEVel[: IM Mediate] 

- *RSTOondition: OUTP:EXTernal:SOURce NONE 

Example 

Select TTLTrgO* to Drive the Trig Out Port 
OUTP:EXT:SOURTTLTO 

lEXTernaiiSOURce? 

OUTPut:EXTernal:SOURce? queries for the source currently driving the Trig Out 
port. 

Comments 

- Querying the source with :STATe OFF returns NONE, regardless of the 
actual source setting. 

Example 

Determine the Source Driving Trig Out 
OUTP:EXT:SOUR? 

enter statement Return Trig Out source. 
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:EXTema[[:STATe] 

OUTPut:EXTerna[[:STATe] <mode> enables configuration (for example, source 
and level) of the command module’s Trig Out port. 

Parameters 


Parameter 

Name 

Parameter 

Type 

Range of Values 

Default 

Units 

<mode> 

boolean 

0|1 |0FF|0N 

none 


Comments 

- When the Trig Out port is set to logic level 1, it remains set if 
OUTP:EXTernal:STATe is set to OFF. Setting OUTP:EXTernal:STATe back to 
ON sets the Trig Out port back to logic level 0. OUTP:EXTernal:SOURce is 
set to NONE. 

- Related Oommands: OUTP:EXTernal:SOURce, 

OUTP:EXTernal:LEVel[: IM Mediate] 

- *RSTOondition: OUTP:EXTernal[:STATe] 0 

Example 

Enable the Trig Out Port 
OUTP:EXT:STATON 

:EXTema[[:STATe]? 

OUTPut:EXTernal[:STATe]? returns the current state (ON or OFF) of the Trig Out 
port. 

Example 

Query the State of Trig Out Port 
OUTP:EXT:STAT? 

enter statement Return the current state. 
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:TTLTrg < n >: IM M ed iate 

OUTPut:TTLTrg<n>:IMMediate causes a pulse to appear on the specified TTL 
trigger line. 

Comments 

- TTLTrg<n> represents TTLTrgO through TTLTrg7. 

- OUTP:TTLTrg<n>:STATe must be ON and OUTP:TTLTrg<n>:SOURce must 
be set to INT or NONE in order to issue an immediate pulse. An error 
message is generated if :STATe is not ON. 

- Related Oommands: OUTP:TTLTrg<n>:SOURce, OUTP:TTLTrg<n>[:STATe] 

Example 

Send Trigger Pulse to TTLTrgO* 

OUTP:TTLTO:STAT ON 
OUTP:TTLT4:STAT ON 
OUTP:TTLTO:SOUR INT 
OUTP:TTLT4:SOUR INT 
OUTP:TTLTO:IMM 
OUTP:TTLT4:IMM 

:TTLTrg<n>:LEVe[[:IMMediate] 

Parameters 

OUTPut:TTLTrg<n>:LEVel[:IMMediate] <level> sets the selected TTLTrg* trigger 
line to logic level 0 or 1. 


and TTLTrg4* 

Enable the System instrument. 
Send a pulse on TTLTO and TTLT4. 

Set trigger sources. 

Pulse the TTLTrgO bus. 

Pulse the TTLTrg4 bus. 


Parameter 

Name 

Parameter 

Type 

Range of Values 

Default 

Units 

<n> 

numeric 

0 through 7 

N/A 

< level > 

boolean 

0|1 |0FF|0N 

none 


Comments 

- OUTP:TTLTrg<n>:STATe must be ON for the source to drive the trigger line. 
Setting :STATe OFF does not change the source, so the signal driving the 
line is still present. Setting :STATe back ON sets the source to NONE and 
de-asserts the line. 
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- OUTPut:TTLTrg<n>:SOURce must be INTernal. 

- Related Commands: OUTP:TTLTrg<n>:LEVel[:IMMediate]?, 
OUTP:TTLTrg<n>:SOURce, OUTP:TTLTrg<n>[:STATe] 

- *RST Condition: OUTP:TTLTrg<n>:LEVel 0 

Example 

TTLTrgO* Set to Logic Level 1 
OUTP:TTLTO:STAT ON 
OUTP:TTLTO:SOUR INT 
OUTP:TTLTO:LEV 1 

iTTLTrg < n >: LEVe[[: IM Med iate]? 

OLJTPut:TTLTrg<n>:LEVel[:IMMediate]? returns the current logic level of the 
selected TTLTrg* trigger line specified by n 0 through 7. 

Comments 

- TTLTrg<n> represents TTLTrgO through TTLTrg7. 

Example 

Determine Current State of TTLTrgl* 

OUTP:TTLTl:LEV? 
enter statement 

:TTLTrg<n>:SOURce 

OUTPut:TTLTrg<n>:SOLJRce <source> selects which source will drive the 
selected trigger line. 

Parameters 


Ask for level. 

Return state of trigger line. 


Enable TTLTO. 

Set souroe to internal. 
Set trigger level. 


Parameter 

Name 

Parameter 

Type 

Range of Values 

Default 

Units 

<n> 

numeric 

0 through 7 

N/A 

<source> 

discrete 

INT 1 EXT 1 NONE 

none 
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Comments 

- INT allows the selected trigger line to be driven by OUTP:TTLTrgn:LEVel 
commands. 

- EXT allows the selected trigger line to be driven by the Trig In front panel 
SMB connector. 

- OUTP:TTLTrg<n>:STATe must be ON for the source to drive the trigger line. 
Setting :STATe OFF does not change the source, so the signal driving the 
line is still present. Setting :STATe back ON sets the source to NONE and 
de-asserts the line. 

- Related Oommands: OUTP:TTLTrg<n>[:STATe], 

OUTPTTLTrg < n >: LEVel[: IM Mediate] 

- *RSTOondition: OUTP:TTLTrg<n>:SOURce NONE 

Example 

Select the Trig In Oonnector to Drive TTLTrgO* 

OUTP:TTLTO:SOUR EXT 

:TTLTrg<n>:SOURce? 

OUTPut:TTLTrg<n>:SOURce? queries the source currently driving the selected 
trigger line. 

Comments 

- TTLTrg<n> represents TTLTrgO through TTLTrg7. 

- Querying the source with :STATe OFF returns NONE, regardless of the 
actual source setting. 

Example 

Determine the Source Driving TTLTrgl* 

OUTP:TTLTl:SOUR? 

enter statement Return trigger source. 
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:TTLTrg<n>[:STATe] 

OUTPut:TTLTrg<n>[:STATe] <mode> controls whether the System instrument 
may drive the specified trigger line. 

Parameters 


Parameter 

Name 

Parameter 

Type 

Range of Values 

Default 

Units 

<n> 

numeric 

0 through 7 

N/A 

<mode> 

boolean 

0|1 |0FF|0N 

none 


Comments 

- OUTP:TTLTrg<n>:STATe must be ON in order to specify a trigger source, 
issue a pulse, or set a trigger level. 

- OUTP:TTLTrg<n>:STATe must be ON for the source to drive the trigger line. 
Setting :STATe OFF does not change the source, so the signal driving the 
line is still present. Setting :STATe back ON sets the source to NONE and 
de-asserts the line. 

- Related Oommands: OUTP:TTLTrg<n>:SOURce, 
OUTP:TTLTrg<n>:LEVel[:IMMediate] 

- *RST Oondition: OUTP:TTLTrg<n>:STATe 0 

Example 

Enable the TTLTrgl* Trigger Line 
OUTP:TTLTl:STATON 

:TTLTrg<n>[:STATe]? 

OUTPut:TTLTrg<n>[:STATe]? returns the current state (ON or OFF) of the selected 
trigger line. 

Comments 

- TTLTrg<n> representsTTLTrgO through TTLTrg?. 

Example 

Query the State of TTLTrgl* 

OUTPTTLTl :STAT? 

enter statement Return the current state. 
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The PROGram subsystem allows you to write an operating system into the 
command module Flash ROM, to read data from the Flash ROM, or to delete the 
contents of the Flash ROM. PROG:DEFine? and PROG:DEFine:GFIEGked? are 
valid in SYSTEM or LOAD mode. The other PROGram commands listed are active 
ONLY in LOAD mode. 


Subsystem Syntax 

PROGram 

[:SELected] 

:DEFine 

:GFIEGked <op_sys> 
:GHEGked? 

:DEFine? 

:DELete 


[:SELected]:DEFine 

PROGram[:SELected]:DEFine <op_sys> writes the operating system intoFlash 
ROM. 

Parameters 


Parameter 

Name 

Parameter 

Type 

Range of Values 

Default 

Units 

<op_sys> 

arbitrary block 
program data 

See comments below. 

none 


Comments 

- This command returns an error if executed from the System instrument 
(switch set to the "Run" position). 

- Arbitrary Block Program Data parameters are used to transfer blocks of 
data in the form of bytes. The block of data bytes is preceded by a 
preamble which indicates either 1) the number of data bytes which follow, 
or 2) that the following data block will be terminated upon receipt of a New 
Line message with the EOl signal true. The syntax is: 

Definite Length Block 

#<non-zero digit><digit(s)><data byte(s)> 
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Where the value of <non-zero digit> equals the number of <digit(s)>. The 
value of <digit(s)> taken as a decimal integer indicates the number of 
<data byte(s)> in the block. 

Indefinite Length Block 

#0<data byte(s)><NL^END> 

Examples of sending 4 data bytes: 

# 14 < byte X byte X byte > < byte > 

#3004 < byte > < byte > < byte > < byte > 

#0 < byte X byte X byte X byte X N L^E N D > 

- Related Commands: PROG[:SELected]:DELete 

[:SELected]:DEFine iCHECked 

Parameters 

PROGram[:SELected]:DEFine:CHECked <op_sys> writes the operating system 
into Flash ROM over an RS-232 line. 


Parameter 

Name 

Parameter 

Type 

Range of Values 

Default 

Units 

<op_sys> 

arbitrary block 
program data 

See comments below. 

none 


Comments 

- This command returns an error if executed from the System instrument. 

- Arbitrary Block Program Data parameters are used to transfer blocks of 
data in the form of bytes. The block of data bytes is preceded by a 
preamble which indicates either 1) the number of data bytes which follow, 
or 2) that the following data block will be terminated upon receipt of a New 
Line message with the EOl signal true. The syntax is: 

Definite Length Block 

#<non-zero digitxdigit(s)xdata byte(s)> 

Where the value of <non-zero digit> equals the number of<digit(s)>. The 
value of <digit(s)> taken as a decimal integer indicates the number of 
<data byte(s)> in the block. 
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Indefinite Length Block 

#0<data byte(s)><NL^END> 

Examples of sending 4 data bytes: 

#14 < byte > < byte > < byte > < byte > 

#3004 < byte > < byte > < byte > < byte > 

#0 < byte > < byte > < byte > < byte ><NL^END> 

Related Commands: PROG[:SELected]:DELete 

Byte Format 

Each byte sent with this command is expected to be in the following format: 


Bit# 

7 

6 

5 

4 

3 

2 

1 

0 


Control Bit 

Check Bits 

Data Bits 


— Control Bit is used to indicate the serial driver information such as clear, 
reset, or end of transmission. This bit is ignored by the regular 488.2 
driver. The control bit should be one for regular data. 

— Check Bits are used to detect and correct a single bit error. The control 
bit is not included in the check. The check bits are a Hamming single bit 
error correction code, as specified by the following table: over an 
RS-232 line. 


Data Value 

Check Bits 

0 

0 

1 

7 

2 

6 

3 

1 

4 

5 

5 

2 

6 

3 

7 

4 

8 

3 

9 

4 

10 

5 

11 

2 

12 

6 

13 

1 

14 

0 

15 

7 
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— Data Bits are the actual data being transferred (four bits at atime). Each 
word to be written requires four data bytes for transmission. The 
significance of the data is dependent on the order received. The first 
data byte received contains the most significant nibble of the 16-bit 
word to be written (bits 15-12). 

The next data byte received contains the least significant nibble of the 
most significant byte of the word (bits 11-8). The third data byte received 
contains the most significant nibble of the least significant byte of the word 
(bits 7-4). The fourth data byte received contains the least significant 
nibble of the least significant byte of the word to be written (bits 3-0). Once 
all four bytes have been received the word will be written. 

[:SELected]:DEFine iCHECked? 

PROGram[:SELected]:DEFine:CHECked? reads data from Flash ROM over an 

RS-232 line. 

Comments 

- This command returns a definite length arbitrary block of data in the same 
format used to send data over RS-232. 


[:SELected]:DEFine? 

PROGram[:SELected]:DEFine? reads data from the Flash ROM. 

Comments 

This command returns the operating system program loaded in Flash ROM as a 
definite length arbitrary block. 
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[:SELected]:DELete 

PROGram[:SELected]:DELete erases the entire contents of the Flash ROM. 

Comments 

- This command returns an error if executed from the System instrument. 


CAUTION 


This command will remove the Keysight E1406A operating system 
and should NEVER be used unless you are updating the operating 
system. Do not use this command when addressing instruments 
other than the command module, as the results may be 
undetermined and may cause the instrument to fail. 
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STATUS Subsystem 

The STATUS subsystem commands access the Condition, Event, and Enable 
Registers in the Operation Status Group and the Questionable Data Group. 

Subsystem Syntax 

STATUS 

:OPERation 

:CONDition? 

:ENABle <event> 

:ENABle? [:EVENt]? 

:NTRansition <unmask> 

:PTRansition <unmask> 

:PRESet 

:QUEStionable 

:CONDition? 

:ENABle <event> 

:ENABle? [:EVENt]? 

:NTRansition <unmask> 

:PTRansition <unmask> 

:OPERation:CONDition? 

STATus:OPERation:CONDition? returns the state of the Condition Register in the 
Operation Status Group. The state represents conditions which are part of an 
instrument’s operation. 

Comments 

- Bit 8 in the register is used by the System instrument (command module) 
to indicate when an interrupt set up by the DIAGdNTerrupt commands has 
been acknowledged. 

- Reading the Condition Register does not change the setting of bit 8. Bit 8 
is cleared by the DIAG:INTerrupt:RESPonse? command. 

- Related Commands: STAT:OPER:ENABle, STAT:OPER[:EVENt]? 

Example 

Read the Contents of the Condition Register 

STAT:OPER:COND? Query register. 

enter statement 
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:OPERation:ENAB[e 

STATus:OPERation:ENAB[e <event> sets an enable mask to allow events 
monitored by the Condition Register and recorded in the Event Register, to send 
a Summary bit to the Status Byte Register (bit 7). 

Parameters 


Parameter 

Name 

Parameter 

Type 

Range of Values 

Default 

Units 

<event> 

numeric 

256 

none 


Comments 

- Bit 8 in the Condition Register is used by the System instrument 
(command module) to indicate when an interrupt set up by the 
DIAG:INTerrupt commands has been acknowledged. 

- Bit 8 is the only bit used in the Condition Register (by the System 
instrument), therefore, it is the only bit which needs to be unmasked in the 
Event Register. Specifying the "bit weight" for the event unmasks the bit. 
The bit weight is 256 and can be specified in decimal, hexadecimal (#H), 
Octal (#0) or binary (#B). 

- When the Summary bit is sent, it sets bit 7 in the Status Byte Register. 

- Related Commands: STAT:OPER:ENABle? 

Example 

Unmask Bit 8 in the Event Register 

STAT:OPER:ENAB 256 Unmask bit 8. 

:OPERation:ENAB[e? 

STATus:OPERation:ENABle? returns which bits in the Event Register (Operation 

Status Group) are unmasked. 

Comments 

- Bit 8 in the Condition Register is used by the System instrument 
(command module) to indicate when an interrupt set up by the 
DIAG:INTerrupt commands has been acknowledged. 

- Bit 8 in the Event Register generally is the only bit which will be unmasked. 
If this bit is unmasked when STAT:OPER:ENABle? is sent, 256 is returned. 

- Reading the Event Register mask does not change the mask setting 
(STAT:OPER:ENABle <event>). 
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- Related Commands: STAT:OPER:ENABle 

Example 

Read the Event Register Mask 

STAT:OPER:ENAB? Query register mask. 

enter statement 


:OPERation[:EVENt]? 

STATus:OPERation[:EVENt]? returns which bits in the Event Register (Operation 
Status Group) are set. The Event Register indicates when there has been a 
positive transition in the Condition Register. 

Comments 

- Bit 8 in the Condition Register is used by the System instrument 
(command module) to indicate when an interrupt set up by the 
DIAG:INTerrupt commands has been acknowledged. 

- Bit 8 in the Event Register generally is the only bit which is used. If this bit 
is set when STAT:OPER:EVENt? is sent, 256 is returned. 

- Reading the Event Register clears the contents of the register. If the Event 
Register is to be used to generate a service request (SRQ), you should 
clear the register before enabling the SRQ (*SRE). This prevents an SRQ 
from occurring due to a previous event. 

- Related Commands: STAT:OPER:ENABle, STAT:OPER:ENABle? 

Example 

Read the Event Register 

STAT:OPER:EVEN? Query if bit(s) is set. 

enter statement 
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:OPERation :NTRansition 

STATus:OPERation:NTRansition <unmask> sets the negative transition mask. For 
each bit unmasked, a 1-to-0 transition of that bit in the associated Condition 
Register will set the same bit in the associated Event Register. 

Parameters 


Parameter 

Name 

Parameter 

Type 

Range of Values 

Default 

Units 

<unmask> 

numeric or 

non-decimal 

numeric 

0 through +32767 

none 


The non-decimal numeric forms are the #H, #Q, or #B formats specified by 
IEEE-488.2. 

Comments 

- Executable when initiated. 

- No coupled commands. 

- *RST Condition: No change. 

- Related Commands: STATus subsystem commands, *SRE, *STB? 

Example 

Set the Operation Register Negative Transition Mask 

STAT:OPER:NTR 64 Set event bit when wait-for-arm state is entered. 

lOPERation iPTRansition 

STATus:OPERation:PTRansition <unmask> sets the positive transition mask. For 
each bit unmasked, a 0-to-l transition of that bit in the associated Condition 
Register will set the same bit in the associated Event Register. 

Comments 

- See STATus:OPERation:NTRansition <unmask> for parameters and 
comments. 

Example 

Set the Operation Register Positive Transition Mask 

STAT:OPER:PTR 64 Set event bit when wait-for-arm state is entered. 
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:PRESet 


STATus:PRESet sets each bit in the Enable Register (Standard Operation Status 
Group) to ‘O’. 

Example 

Preset the Enable Register 

STAT:PRES Preset Enable Register. 

:(5UEStionab[e:CONDition? 

STATus:0UEStionable:CONDition? returns the state of the Condition Register in 
the Questionable Status Group. The state represents conditions which are part of 
an instrument’s operation. 

Comments 

- Related Commands: STAT:OUES:ENABle, STAT:OUES[:EVENt]? 

Example 

Read the Contents of the Condition Register 

STAT:0UES:COND Query register. 


NOTE 


STATus:OUEStionable commands are supported by the System 
instrument, however, they are not used by the System instrument. 
Queries of the Questionable Data Condition and Event Registers 
will always return +0. 


:QUEStionab[e:ENABle 

STATus:OUEStionable:ENABle <event> sets an enable mask to allow events 
monitored by the Condition Register and recorded in the Event Register, to send 
a summary bit to the Status Byte Register (bit 7). 

Parameters 


Parameter 

Name 

Parameter 

Type 

Range of Values 

Default 

Units 

<event> 

numeric 

256 

none 
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Comments 

- When the summary bit is sent, it sets bit 7 in the Status Byte Register. 

- Related Commands: STAT:QUES:ENABle? 

Example 

Unmask Bit 8 in the Event Register 

STAT:QUES:ENAB 256 Unmask bit 8. 

iQUEStionabieiENABle? 

STATus:QUEStionable:ENABle? returns which bits in the Event Register 
(Questionable Status Group) are unmasked. 

Comments 

- Reading the Event Register mask does not change the mask setting 
(STAT:QUES:ENABle <event>). 

- Related Commands: STAT:QUES:ENABle 

Example 

Read the Event Register Mask 

STAT:QUES:ENAB? Query register mask. 

:QUEStionab[e[:EVENt]? 

STATus:QUEStionable[:EVENt]? returns which bits in the Event Register 
(Questionable Status Group) are set. The Event Register indicates when there has 
been a positive transition in the Condition Register. 

Comments 

- Reading the Event Register clears the contents of the register. If the Event 
Register is to be used to generate a service request (SRQ), you should 
clear the register before enabling the SRQ (*SRE). This prevents an SRQ 
from occurring due to a previous event. 

- Related Commands: STAT:QUES:ENABle, STAT:QUES:ENABle? 

Example 

Read the Event Register 

STAT:QUES:EVEN? Query returns bit(s) set. 
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:QUEStionab[e:NTRansition 

STATus:QUEStionab[e:NTRansition <unmask> sets the negative transition mask. 
For each bit unmasked, a 1 -to-0 transition of that bit in the associated Condition 
Register will set the same bit in the associated Event Register. 

Parameters 


Parameter 

Name 

Parameter 

Type 

Range of Values 

Default 

Units 

<unmask> 

numeric or 

non-decimal 

numeric 

0 through +32767 

none 


The non-decimal numeric forms are the #H, #Q, or #B formats specified by 
IEEE-488.2. 

Comments 

- Executable when initiated. 

- No coupled commands. 

- *RST Condition: No change. 

- Related Commands: STATus subsystem commands, *SRE, *STB? 

Example 

Set the Questionable Signal Register Negative Transition Mask. 

STAT:QUES:NTR 64 Set event bit when wait-for-arm state is entered. 

:QUEStionab[e:PTRansition 

STATus:QUEStionable:PTRansition <unmask> sets the positive transition mask. 
For each bit unmasked, a 0-to-l transition of that bit in the associated Condition 
Register will set the same bit in the associated Event Register. 

Comments 

- See STATus:QUEStionable:NTRansition <unmask> for parameters and 
comments. 

Example 

Set the Questionable Signal Register Positive Transition Mask. 

STAT:QUES:PTR 64 Set event bit when wait-for-arm state is entered. 
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SYSTem Subsystem 

The SYSTem command subsystem for the System instrument provides for: 

- Control and access of the System instrument’s real time clock/calendar 
(SYST:TIME, SYST:TIME?, SYST:DATE, SYST:DATE?). 

- Access to the System instrument’s error queue (SYST:ERRor?). 

- Configuring the communication ports (GRIB and serial). 


Subsystem Syntax 

SYSTem 

:COMMunicate 

:GPIB 

:ADDRess? 

:SERial[n] 

:CONTrol 

:DTR <dtr_cntrl>| ON | OFF | STANdard | IBFull 
:DTR? 

:RTS <rts_cntrl>| ON | OFF | STANdard | IBFull 
:RTS? 

[:RECeive] 

:BAUD <baud_rate>| MIN | MAX 
:BAUD? [MIN I MAX] 

:BITS <bits>| 7 I 8 I MIN I MAX 
:BITS? [MIN I MAX] 

:PACE 

[:PROTocol] <protocol> XON | NONE 
[:PROTocol]? 

:THReshold 

:STARt <char_count> 

:STARt? [MIN I MAX] 

:STOP <char_count> 

:STOP? [MIN I MAX] 

:PARity 

<type>| EVEN | ODD | ZERO | ONE | NONE 
<type>? 

:CHECk <check_cntrl>| 1 | 0 | ON | OFF 
:CHECk? 

:SBITs <sbits>| 1 | 2 | MIN | MAX 
:SBITs? [MIN I MAX] 

:TRANsmit 

:AUTO <auto_cntrl>| 1 | 0 | ON | OFF 
:AUTO? 

:PACE 

[:PROTocol] <protocol> XON | NONE 
[:PROTocol]? 
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DATE <year>,<month>,<day> 

DATE? [MIN I MAX,MIN | MAX,MIN | MAX] 
ERRor? 

TIME <hour>,<minute>,<second> 

TIME? [MIN I MAX,MIN | MAX,MIN | MAX] 
VERSIon? 


:COMMunicate:GPIB:ADDRess? 

SYSTem:COMMunicate:GPIB:ADDRess? returns the Keysight E1406A Command 
Module’s primary GPIB address. 

Comments 

- The Keysight E1406A Command Module (primary) GPIB address is set 
using switches on the module. 

Example 

Read the Primary GPIB Address 

SYST:COMM:GPIB:ADDR? 
enter statement 


Read the GPIB address. 
Enter the GPIB address. 


:COMMunicate:SERia[[n]:? 

The SYSTem:COMMunicate:SERial[n]:... commands set and/or modify the 
configuration of the serial interface(s) that are under control of the System 
instrument (command module). The interface to be affected by the command is 
specified by a number (zero through seven) which replaces the [n] in the 
SERial[n] command. The number is the interface’s card number. Card number 
zero specifies the command module’s built-in interface while one through seven 
specify one of up to seven Keysight El 324 B-size plug-in serial interface 
modules. The serial interface installed at (System instrument’s logical address) 
+1 becomes card number 1, the serial interface installed at the next sequential 
logical address becomes card number 2, and so on. The logical addresses used 
by plug-in serial interfaces must start at (System instrument’s logical address) +1 
and be contiguous (no unused logical addresses). The factory set logical address 
of the Keysight E1406A Command Module is 0. 

Comments 

- Serial communication commands take effect after the end of the program 
message containing the command. 

- Serial communication settings for the built-in RS-232 interface can be 
stored in its non-volatile RAM only after the DIAG:COMM:SERial[n]:STORe 
command is executed. These settings are used at power-up and 
DiAG:BOOT[:WARM]. 
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- Serial communication settings for the Keysight El 324A RS-232/422 
Terminal Interface can be stored in its on-board non-volatile EEROM only 
after the DIAG:COMM:SER[n]:STOR command is executed. These settings 
are used at power-up and DIAG:BOOT[:WARM]. 

- DIAG:BOOT:GOLD will set the serial communication parameters to the 
following defaults: 

- BAUD 9600 

- BITS 8 

- PARityNONE 

- SBITs 1 

- DTR ON 

- RTS ON 

- PAGEXON 


Example 

Set Baud Rate for Plug-In Gard 2 

SYST:GOMM:SER2:BAUD 9600 (must be a card number 1 also) 

:COMMunicate:SERia[[n]:CONTro[:DTR 

SYSTem:GOMMunicate:SERIal[n]:GONTrol:DTR <dtr_cntrl> controls the 
behavior of the Data Terminal Ready output line. DTR can be set to a static state 
(ON I OFF), can operate as a modem control line (STANdard), or can be used as a 
hardware handshake line (IBFull). 

Parameters 


Parameter 

Name 

Parameter 

Type 

Range of Values 

Default 

Units 

<dtr_cntr[> 

discrete 

ON 1 OFF 1 STAN | IBF 

none 


Comments 

- The following table defines each value of dtr_cntrl: 


Value 

Definition 

ON 

DTR Line is asserted. 

OFF 

DTR Line is unasserted. 
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STANdard 

DTR will be asserted when the serial interface is ready to send 
output data. Data will be sent if the connected device asserts 

DSR and CTS. 

IBFull 

While the input buffer is not yet at the :STOP threshold, DTR is 
asserted. When the input buffer reaches the :STOP threshold, 
DTR will be unasserted. 


- DIAG:BOOT:COLDwi[[setDTRtoON. 

- Related Commands: SYST:COMM:SER[n]:CONT:RTS, 
SYST:COMM:SER[n][:REC]:PACE:THR:STARt, 
SYST:COMM:SER[n][:REC]:PACE:THR:STOP 

- *RST Condition: No change. 

Example 

Assert the DTR Line 

SYST:COMM:SERO:CONT:DTR ON 

:COMMunicate:SERia[[n]:CONTro[:DTR? 

SYSTem:COMMunicate:SERial[n]:CONTrol:DTR? returns the current setting for 
DTR line control. 

Example 

Check the Setting of DTR Control 
SYST:COMM:SERO:CONT:DTR? 

enter statement Statement enters the string "ON", 

"OFF", "STAN", or "IBF". 


:COMMunicate:SERia[[n]:CONTro[:RTS 

SYSTem:COMMunicate:SERial[n]:CONTrol:RTS <rts_cntrl> controls the behavior 
of the Request To Send output line. RTS can be set to astatic state (ON | OFF), 
can operate as a modem control line (STANdard), or can be used as a hardware 
handshake line (IBFull). 

Parameters 


Parameter 

Name 

Parameter 

Type 

Range of Values 

Default 

Units 

<rts_cntrl> 

discrete 

ON 1 OFF 1 STAN | IBF 

none 
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Comments 

- The following table defines each value of rts_cntrl: 


Value 

Definition 

ON 

RTS Line is asserted. 

OFF 

RTS Line is unasserted. 

STANdard 

RTS will be asserted when the serial interface is ready to send output data. 
Data will be sent if the connected device asserts CTS and DSR. 

IBFull 

While the input buffer is not yet at the :STOP threshold, RTS is asserted. 

When the input buffer reaches the :STOP threshold, RTS will be unasserted. 


- DIAG:BOOT:COLDwillsetRTStoON. 

- Related Commands: SYST:COMM:SER[n]:CONT:DTR, 
SYST:COMM:SER[n][:REC]:PACE:THR:STARt, 
SYST:COMM:SER[n][:REC]:PACE:THR:STOP 

- *RST Condition: No change. 

Example 

Unassert the RTS Line 

SYST:COMM:SERO:CONT:RTS OFF 

:COMMunicate:SERia[[n]:CONTro[:RTS? 

SYSTem:COMMunicate:SERial[n]:CONTrol:RTS? returns the current setting for 
RTS line control. 

Example 

Check the Setting of RTS Control 
SYST:COMM:SERO:CONT:RTS? 

enter statement Statement enters the string "ON", 

"OFF", "STAN", or "IBF". 
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:COMMunicate:SERia[[n][:RECeive]:BAUD 

SYSTem:COMMunicate:SERia[[n][:RECeive]:BAUD <baud_rate> sets the baud 
rate for the serial port. 

Parameters 


Parameter 

Name 

Parameter 

Type 

Range of Values 

Default 

Units 

<baud_rate> 

numeric 

300112001240014800196001 
192001 MINI MAX 

none 


Comments 

- Attempting to set baud_rate to other than those values shown will result in 
an Error -222, "Data out of range". 

- DIAG:BOOT:COLD will set BAUD to 9600. 

- *RST condition: No change. 

Example 

Set the Baud Rate to 1200 

SYST:COMM:SERO:BAUD 1200 

:COMMunicate:SERia[[n][:RECeive]:BAUD? 

SYSTem:COMMunicate:SERial[n][:RECeive]:BAUD? [MIN | MAX] returns: 

— The current baud rate setting if no parameter is sent. 

— The maximum allowable setting if MAX is sent. 

— The minimum allowable setting if MIN is sent. 

Example 

Query the Current Baud Rate 
SYST:COMM:SER0:BAUD? 

enter statement Statement enters a numeric value. 
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:COMMunicate:SERia[[n][:RECeive]:BITS 

SYSTem:COMMunicate:SERia[[n][:RECeive]:BITS <bits> sets the number of bits 
to be used to transmit and receive data. 

Parameters 


Parameter 

Name 

Parameter 

Type 

Range of Values 

Default 

Units 

<bits> 

numeric 

7181 MIN 1 MAX 

none 


Comments 

- Attempting to set bits to other than those values shown will result in an 
Error -222, "Data out of range". 

- While this command operates independently of either the 

- PARity <type> or ...SBITs commands, there are two combinations which are 
disallowed because of their data frame bit width. The following table 
shows the possible combinations: 


... BITS 

... PARity <type> 

... SBITs 

Frame Bits 

7 

NONE 

1 

9 - disallowed 

7 

NONE 

2 

10 

7 

Yes 

1 

10 

7 

Yes 

2 

11 

8 

NONE 

1 

10 

8 

NONE 

2 

11 

8 

Yes 

1 

11 

8 

Yes 

2 

12 - disallowed 


- DIAG:BOOT:COLD will set ...BITS to 8. 

- Related Commands: SYST:COMM:SER[n][:REC]:PAR 

- *RST Condition: No change. 

Example 

Configure Data Width to 7 Bits 
SYST:COMM:SERO:BITS 7 
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:COMMunicate:SERia[[n][:RECeive]:BITS? 

SYSTem:COMMunicate:SERia[[n][:RECeive]:BITS? [MIN | MAX] returns: 

— The current data width if no parameter is sent. 

— The maximum aiiowabie setting if MAX is sent. 

— The minimum aiiowabie setting if MIN is sent. 

Example 

Query the Current Data Width 
SYST:COMM:SERO:BITS? 

enter statement Statement enters 7 or 8. 

:COI\/II\/lunicate:SERia[[n][:RECeive]:PACE[:PROToco[] 

SYSTem:COMMunicate:SERiai[n][:RECeive]:PACE[:PROTocoi] <protocoi> 
enables or disables receive pacing (XON/XOFF) protocol. 

Parameters 


Parameter Name 

Parameter Type 

Range of Values 

Default Units 

<protoco[> 

discrete 

XON1 NONE 

none 


Comments 

- While ...PROT is XON, the serial interface will send XOFF when the buffer 
reaches the ...STOP threshold, and XON when the buffer reaches the 
...STARt threshold. 

- For an Keysight E1324A, AUTO is always ON. In this case 
...[:RECeive]:PACE will also set ...TRAN:PACE 

- The XON character is Control Q (ASCII 1710, 1116), The XOFF character is 
Controls (ASCII 1910, 1316). 

- DIAG:BOOT:COLD will set ...PACE to XON. 

- Related Commands: SYST:COMM:SER[n][:REC]:PACE:THR:STARt, 
SYST:COMM:SER[n][:REC]:PACE:THR:STOP, 
SYST:COMM:SER[n]TRAN:AUTO 

- *RST Condition: No change. 

Example 

Enable XON/XOFF Handshaking 

SYST:COMM:SERO:PACE:PROT XON 
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:COMMunicate:SERia[[n][:RECeive]:PACE[:PROToco[]? 

SYSTem:COMMunicate:SERia[[n][:RECeive]:PACE[:PROToco[]? returns the 
current receive pacing protocol. 

Example 

See if XON/XOFF Protocol is Enabled 
SYST:COMM:SERO:PACE:PROT? 

enter statement Statement enters the string "XON" or "NONE". 

:COMMunicate:SERia[[n][:RECeive]:PACE:THResho[d:STARt 

SYSTem:COMMunicate:SERial[n][:RECeive]:PACE:THReshold:STARt 
<char_count> configures the input buffer level at which the specified interface 
may send the XON character (ASCII 1116), assert the DTR line, and/or assert the 
RTS line. 

Parameters 


Parameter 

Name 

Parameter 

Type 

Range of Values 

Default 

Units 

<char_count> 

numeric 

1 through 99 for built-in, 

1 through 8191 forE1324A 

none 


Comments 

- To determine the size of the input buffer of the serial interface you are 
using, send SYST:COMM:SER[n]:PACE:THR:STARt? MAX. The returned 
value will be the buffer size less one. 

- ...STARt must be set to less than ...STOP. 

- The ...THR:STAR command has no effect unless 

- ...PACE:PROTXON, ...CONT:DTR IBF, or ...CONT:RTS IBF has been sent. 

- Related Commands: SYST:COMM:SER[n][:REC]:PACE[:PROT] XON | NONE, 
SYST:COMM:SER[n]:CONT:DTR, 

SYST:COMM:SER[n]:CONT:RTS 

- *RST Condition: No change. 

Example 

Set Interface to Send XON When Input Buffer Contains 10 Characters 

SYST:COMM:SERO:PACE:PROT XON 
SYST:COMM:SERO:PACE:THR:STAR 10 
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:COMMunicate:SERia[[n][:RECeive]:PACE:THResho[d:STARt? 

SYSTem:COMMunicate:SERia[[n][:RECeive]:PACE:THResho[d:STARt [MIN | MAX] 
returns: 


— The current start threshold if no parameter is sent. 

— The maximum allowable setting if MAX is sent. 

— The minimum allowable setting if MIN is sent. 

Comments 

- To determine the size of the input buffer of the serial interface you are 
using, send SYST:COMM:SER[n]:PACE:THR:STARt? MAX. The returned 
value will be the buffer size less one. 

Example 

Return Current Start Threshold 

SYST:COMM:SERO:PACE:THR:STAR? Query for threshold value. 
enter statement Statement enters a numerio value. 


:COMMunicate:SERia[[n][:RECeive]:PACE:THResho[d:STOP 

SYSTem:COMMunicate:SERial[n][:RECeive]:PACE:THReshold:STOP 
<char_count> configures the input buffer level at which the specified interface 
may send the XOFF character (ASCII 1316), de-assert the DTR line, and/or 
de-assertthe RTS line. 

Parameters 


Parameter 

Name 

Parameter 

Type 

Range of Values 

Default 

Units 

<char_count> 

numeric 

1 through 99 for built-in, 

1 through 8191 forE1324A 

none 


Comments 

- To determine the size of the input buffer of the serial interface you are 
using, send SYST:COMM:SER[n]:PACE:THR:STOP MAX. The returned value 
will be the buffer size less one. 

- ...STOP must be set to greater than ...STARt. 

- The ...THR:STOP command has no effect unless 

- ...PACE:PROTXON, ...CONT:DTR IBF, or ...CONT:RTS IBF has been sent. 
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- Related Commands: SYST:COMM:SER[n][:REC]:PACE[:PROT] XON | NONE, 
SYST:COMM:SER[n]:CONT:DTR, SYST:COMM:SER[n]:CONT:RTS 

- *RST Condition: No change. 

Example 

Set Interface to Send XOFF When Input Buffer Contains 80 Characters 
SYST:COMM:SERO:PACE:THR:STOP 80 

:COMMunicate:SERia[[n][:RECeive]:PACE:THResho[d:STOP? 

SYSTem:COMMunicate:SERIal[n][:RECeive]:PACE:THReshold:STOP? [MIN | MAX] 
returns: 


— The current stop threshold if no parameter is sent. 

— The maximum allowable setting if MAX is sent. 

— The minimum allowable setting if MIN is sent. 

Comments 

- To determine the size of the input buffer of the serial interface you are 
using, send SYST:COMM:SER[n]:PACE:THR:STOP? MAX. The returned 
value will be the buffer size less one. 

Example 

Return Current Stop Threshold 

SYST:CO M M:SERO: PACE:TH R:STO P? Query for threshold. 

enter statement Statement enters a numerio value. 


:COMMunicate:SERia[[n][:RECeive]:PARity 

SYSTem:COMMunicate:SERial[n][:RECeive]:PARity <type> configures the type of 
parity to be checked for received data, and generated for transmitted data. 

Parameters 


Parameter 

Name 

Parameter 

Type 

Range of Values 

Default 

Units 

<type> 

discrete 

EVEN 1 ODD 1 ZERO 1 ONE 1 NONE 

none 
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Comments 

- Attempting to set type to other than the values shown results in Error -222, 
"Data out of range". 

- The following table defines each value of <type>: 


Value 

Definition 

EVEN 

If... PARity:CHECk is ON, the received parity bit must maintain 
even parity. The transmitted parity bit will maintain even parity. 

ODD 

If... PARity:CHECk is ON, the received parity bit must maintain 
odd parity. The transmitted parity bit will maintain odd parity. 

ZERO 

If... PARity:CHECk is ON, the received parity bit must be a zero. 
The transmitted parity bit will be a zero. 

ONE 

If... PARity:CHECk is ON, the received parity bit must be a logic 
one. The transmitted parity bit will be a logic one. 

NONE 

A parity bit must not be received in the serial data frame. No 
parity bit will be transmitted. 


- While this command operates independently of either the ...BITS or 

- ...SBITs commands, there are two combinations which are disallowed 
because of their data frame bit width. The following table shows the 
possible combinations: 


... BITS 

... PARity <type> 

... SBITs 

Frame Bits 

7 

NONE 

1 

9 - disallowed 

7 

NONE 

2 

10 

7 

Yes 

1 

10 

7 

Yes 

2 

11 

8 

NONE 

1 

10 

8 

NONE 

2 

11 

8 

Yes 

1 

11 

8 

Yes 

2 

12 - disallowed 


- Received parity will not be checked unless ...PAR:CHEC ON is has been 
sent. Transmitted data will include the specified parity whether 

- ...PAR:CHECisONorOFF. 

- DIAG:BOOT:COLD will set... PARity to NONE. 
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- Related Commands: SYST:COMM:SER[n][:REC]:PAR:CHEC 1 | 0 | ON | OFF, 
SYST:COMM:SER[n][:REC]:BITS 7 | 8, SYST:COMM:SER[n][:REC]:SBIT 1 | 2, 

- *RST Condition: No change. 

Example 

Set Parity Check/Generation to ODD 

SYST:COMM:SERO:PAR ODD Set parity type. 

SYST:COMM:SERO:PAR:CHEC ON Enable parity check/generation. 

:COMMunicate:SERia[[n][:RECeive]:PARity? 

SYSTem:COMMunicate:SERial[n][:RECeive]:PARity? <type> returns the type of 
parity checked and generated. 

Example 

What Type of Parity Checking is Set? 

SYST:COMM:SERO:PAR? Ask for parity type. 

enter statement Returns the string EVEN, ODD, ZERO, 

ONE, or NONE. 


:COMMunicate:SERia[[n][:RECeive]:PARity:CHECk 

SYSTem:COMMunicate:SERial[n][:RECeive]:PARity:CHECk <check_cntrl> 
controls whether or not the parity bit in received serial data frames will be 
considered significant. 

Parameters 


Parameter 

Name 

Parameter 

Type 

Range of Values 

Default 

Units 

<check_cntr[> 

boolean 

0|1 |0FF|0N 

none 


Comments 

- When check_cntrl is set to 0 or OFF, received data is not checked for 
correct parity. Transmitted data still includes the type of parity configured 
with ...PARity <type>. 

- DIAG:BOOT:COLD will set ...CHECk to OFF. 

- Related Commands: SYST:COMM:SER[n][REC]:PAR <type> 

- *RST Condition: No change. 
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Example 

Set Parity Check to ON 

SYST:COMM:SERO:PAR:CHEC ON 

:COMMunicate:SERia[[n][:RECeive]:PARity:CHECk? 

SYSTem:COMMunicate:SERial[n][:RECeive]:PARity:CHECk? returns the state of 
parity checking. 

Example 

Query Parity Checking 

SYST:COMM:SERO:PAR:CHEC? 

enter statement Statement enters 0 or 1. 


:COMMunicate:SERia[[n][:RECeive]:SBITs 

SYSTem:COMMunicate:SERial[n][:RECeive]:SBITs <sbits> sets the number of 
stop bits to be used to transmit and receive data. 

Parameters 


Parameter 

Name 

Parameter 

Type 

Range of Values 

Default 

Units 

<sbits> 

numeric 

1 1 21 MIN 1 MAX 

none 


Comments 

- Attempting to set sbits to other than those values shown will result in an 
Error -222, "Data out of range". 

- While this command operates independently of either the ...BITS or 

- ...PARity <type> commands, there are two combinations which are 
disallowed because of their data frame bit width. The following table 
shows the possible combinations: 


... BITS 

... PARity <type> 

... SBITs 

Frame Bits 

7 

NONE 

1 

9 - disallowed 

7 

NONE 

2 

10 

7 

Yes 

1 

10 

7 

Yes 

2 

11 
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8 

NONE 

1 

10 

8 

NONE 

2 

11 

8 

Yes 

1 

11 

8 

Yes 

2 

12 - disallowed 


- DIAG:BOOT:COLD will set ...SBITs to 1. 

- Related Commands: SYST:COMM:SER[n][:REC]:BAUD 

- *RST Condition: No change. 

Example 

Configure for 2 Stop Bits 

SYST:COMM:SERO:SBITS 2 

:COMMunicate:SERia[[n][:RECeive]:SBITs? 

SYSTem:COMMunicate:SERial[n][:RECeive]:SBITs? [MIN | MAX] returns: 

— The current stop bit setting if no parameter is sent. 

— The maximum allowable setting if MAX is sent. 

— The minimum allowable setting if MIN is sent. 

Example 

Query the Current Stop Bit Configuration 

SYST:CQMM:SERO:SBITs? 
enter statement 

:COMMunicate:SERia[[n]:TRANsnnit:AUTO 

SYSTem:CQMMunicate:SERial[n]:TRANsmit:AUTQ <auto_cntrl> when QN, sets 
the transmit pacing mode to be the same as that set for receive pacing. When 
QFF, the transmit pacing mode may be set independently of the receive pacing 
mode. 

Parameters 


:REC is implied. 
Statement enters 1 or 2. 


Parameter 

Name 

Parameter 

Type 

Range of Values 

Default 

Units 

<auto_cntrl> 

boolean 

0|1|0N|0FF 

none 
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Comments 

- For an Keysight E1324A, AUTO is always ON. Trying to set OFF or 0 will 
generate an error. 

- DIAG:BOOT:OOLD will set ...AUTO to ON. 

- Related Oommands: SYST:OOMM:SER[n][:REO]:PAOE[:PROT], 
SYST:OOMM:SER[n]:TRAN:PAOE[:PROT] 

- *RST Oondition: ...TRAN:AUTO ON 

Example 

Link Transmit Pacing with Receive Pacing 
SYST:OOMM:SERO:TRAN:AUTO ON 

:COMMunicate:SERia[[n]:TRANsnnit:AUTO? 

SYSTem:OOMMunicate:SERial[n]:TRANsmit:AUTO? returns the current state of 
receive to transmit pacing linkage. 

Comments 

- For an Keysight E1324A, AUTO is always ON. In this case ...AUTO? will 
always return a 1. 

Example 

Query if AUTO is ON or OFF 

SYST:GOMM:SERO:TRAN:AUTO? 

enter statement Statement enters the number 1 orO. 

:COI\/IMunicate:SERia[[n]:TRANsnnit:PACE[:PROToco[] 

SYSTem:GOMMunicate:SERial[n]:TRANsmit:PAGE[:PROTocol]<protocol> enables 
or disables the transmit pacing (XON/XOFF) protocol. 

Parameters 


Parameter 

Name 

Parameter 

Type 

Range of Values 

Default 

Units 

<protoco[> 

discrete 

X0N|N0NE 

none 


Comments 

- For an Keysight E1324A, AUTO is always ON. In this case, 
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- ...TRAN:PACE will also set ...[RECeive]:PACE. 

- Receipt of an XOFF character (ASCII 1910, 1316) will hold off transmission 
of data until an XON character (ASCII 1710, 1116) is received. 

- DIAG:BOOT:COLD will set ...PACE to XON. 

- Related Commands: SYST:COMM:SER[n]:TRAN:AUTO 

- *RST Condition: No change. 

Example 

Set XON/XOFF Transmit Pacing 

SYST:COMM:SERO:TRAN:PACE:PROT XON 

:COMMunicate:SERia[[n]:TRANsnnit:PACE[:PROToco[]? 

SYSTem:COMMunicate:SERial[n]:TRANsmit:PACE[:PROTocol]? returns the 
current transmit pacing protocol. 

Example 

Check Transmit Pacing Protocol 

SYST:COMM:SERO:TRAN:PACE:PROT? 

enter statement Statement enters the 

string "XON" or "NONE" 


:DATE 


SYSTem:DATE <year>,<month>,<day> sets the command module’s internal 
calendar. 

Parameters 


Parameter 

Name 

Parameter 

Type 

Range of Values 

Default 

Units 

<year> 

numeric 

Must round to 1980 to 2079. 

none 

<month> 

numeric 

Must round to 1 to 12. 

none 

<day> 

numeric 

Must round to 1 through last day of month. 

none 


Comments 

- The upper limit on the day parameter is dependent on the month 

parameter and may be dependent on the year parameter in the case of a 
leap year. 
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- Related Commands: SYST:TIME, SYST:TIME?, SYST:DATE? 

- *RST Condition: *RST does not change the setting of the calendar. 

Example 

Set the System Date 

SYST:DATE 1996,06,08 Set June 8, 1996. 

:DATE? 

SYSTem:DATE? [MAX | MIN,MAX | MIN,MAX | MIN] returns: 

When no parameter is sent: the current system date in the form 
+YYYY,+MM,+DD, where YYYY can be the year 1980 through 2079, MM can be 
the month 1 through 12, and DD can be the day 1 through 31. 

When parameters are sent: the minimum or maximum allowable values for each 
of the three parameters.The parameter count must be three. 

Example 

Query the System Date 

SYST: DATE? Ask for current date. 

input values of year,month,day Read back date. 


lERRor? 


SYSTem:ERRor? queries the system’s error queue. The response format is: <error 
number>,'Terror description string>". 

Comments 

- As system errors are detected, they are placed in the System instrument 
error queue. The error queue is first in, first out. This means that if several 
error messages are waiting in the queue, each SYST:ERR? query will return 
the oldest error message, and that message will be deleted from the 
queue. 

- If the error queue fills to 30 entries, the last error in the queue is replaced 
with Error -350, "Too many errors". No further errors are accepted by the 
queue until space becomes available using SYST:ERR?, or the queue is 
cleared using *CLS. 

- The SYST:ERR? command can be used to determine if any configuration 
errors occurred during the power-on sequence. 

- When SYST:ERR? is sent while the error queue is empty, the System 
instrument responds with +0,"No error". 
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- Related Commands: *ESE, *ESR?, *SRE 

- *RST Condition: Error queue is cleared. 


Example 


Read All Error Messages From, and Empty the Error Queue 


loop statement 
SYST:ERR? 
enter statement 

until statement 


Loop to read ail errors. 

Ask for error message. 

Input the error (a number), and error 
message (a string) 
until error number is 0. 


TIME 


SYSTem:TIME <hour>,<minute>,<second> sets the command module’s internal 
clock. 

Parameters 


Parameter 

Name 

Parameter 

Type 

Range of Values 

Default 

Units 

<hour> 

numeric 

Must round to 0 to 23. 

none 

<minute> 

numeric 

Must round to 0 to 59. 

none 

<second> 

numeric 

Must round to 0 to 60. 

none 


Comments 

- Related Commands: SYST:DATE, SYST:DATE?, SYST:TIME? 

- *RST Condition: *RST does not change the command module’s real time 
clock. 

Example 

Set the System Time 

SYST:TIME 14,30,20 Set 2:30:20 PM. 


TIME? 


SYSTem:TIME? [MAX | MIN,MAX | MIN,MAX | MIN] returns: 

When no parameter is sent: the current system time is in the form 
+HH,+MM,+SS, where HH can be 0 through 23 hours, MM can be 0 through 59 
minutes, and SS can be 0 through 60 seconds. 
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When parameters are sent: the minimum or maximum allowable values for each 
of the three parameters are returned. The parameter count must be three. 

Example 

Query the System Time 

SYST:TIME? Ask for current time, 

input values of hour,min,sec Read back time. 


iVERSion? 

SYSTem:VERSion? returns the SCPI version for which this instrument complies. 

Comments 


- The returned information is in the format: YYYY.R; where YYYY is the year, 
and R is the revision number within that year. 

- Related Commands: *IDN? 

Example 

Determine Compliance Version for this Instrument 
SYST:VERS? 

enter statement Statement enters 1990.0 
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VXI Subsystem 

The VXI command subsystem provides for: 

— Determining the number, type, and iogicai address of the devices 
(instruments) installed in the C-size mainframe. 

— Direct access to VXIbus A16 registers within devices installed in the 
mainframe. 

— Sending commands using the word serial protocol. 

— Access to message-based devices from an RS-232 terminal. 

Subsystem Syntax 


:CONFigure 

:CTABIe <address> 

:CTABIe? 

:DCTable <address> 

:DCTable? 

:DLADdress? 

:DLISt?[<logical_addr>] 

:DNUMber? 

:ETABIe <address> 

:ETABIe? 

:HIERarchy? 

:ALL? 

:INFormation? 

:ALL? 

:ITABIe <address> 

:ITABIe? 

: LAD Dress? 

:MEXTender? 

:MEXTender 

:ECLTrg<n> <direction> 

:INTerrupt<n> <direction> 

:TTLTrg<n> <direction> 

:MTABIe <address> 

:MTABIe? 

:NUMber? 

:MEXTender? 

:QUERy? <logical_addr> 

:READ? <logical_addr>,<register_addr> 

:RECeive 

[:MESSage]? <logical_addr>[,<end_of_msg>] 
:REGister 

:READ? <register> 
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:WRITe <register>,<data> 

:RESet <[ogicaLaddr> 

:RESet? 

:ROUTe 

:ECLTrg<n> 

:INTerrupt<n> 

:TTLTrg<n> 

:SELect <[ogicaLaddr> 

:S Elect? 

:SEND 

:COMMand <[ogicaLaddr>,<command>[,<data>] 

:COMMand? <[ogicaLaddr>,<command>[,<datal >[,<data2>]] 
[:MESSage] <[ogicaLaddr>,"<msg_string>"[,<end_of_f[ag>] 
:WRITe <[ogicaLaddr>,<register_addr>,<data> 

:WSProtoco[ 

:COMMand 

:AHLine <hand_id>,<[ine_number> 

:AILine <int_id>,<[ine_number> 

:AMContro[ <response_mask> 

:ANO 

:ANY <cmd_word> 
iBAVailable <end_bit> 

:BNO <top_[eve[> 

:BREQuest 

:CEVent <enab[e>,<event_number> 

:CLR 

:CLOCk 

:CRESponse <response_mask> 

:ENO 

:GDEVice <cmdr_[addr> 
dCOMmander 
:RDEVice <[ogicaLaddr> 
iRHANdlers 
:RHLine <hand_id> 

:RILine <int_id> 

:RINTerrupter 

:RMODid 

:RPERror 

:RPRotoco[ 

:RSARea 

:RSTB 

:SLModid <enab[e>,<modid> (0-127) 

:SLOCk 

:SUModid <enab[e>,<modid> (0-63) 

:TRIGger 

:MESSage 

:RECeive? <count | terminator> 

:SEND <msg_string>[,(END | NEN)] 
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:QUERy 

:AHLine? <hand_id>,<[ine_number> 
:AILine? <int_id>,<[ine_number> 
:AMContro[? <response_mask> 

:ANO? 

:ANY? <cmd_word> 

:BNO? <top_[eve[> 

:BREQuest? 

:CEVent? <enab[e>,<event_number> 
:CRESponse? <response_mask> 

:ENO? 

:RDEVice? <[ogicaLaddr> 
iRHANdlers? 

:RHLine? <hand_id> 

:RILine? <int_id> 

:RINTerrupter? 

:RMODid? 

:RPERror? 

:RPRotoco[? 

:RSARea? 

:RSTB? 

:SLModid? <enab[e>,<modid> (0-127) 
:SUModid? <enab[e>,<modid> (0-63) 
:RESPonse? 


:CONFigure:CTAB[e 

VXI:CONFigure:CTAB[e <address> links a user-defined commander/ servant 
hierarchy table to the command module (resource manager) processor. The 
command module must be the acting resource manager in order for the table to 
be implemented. 

Parameters 


Parameter 

Name 

Parameter 

Type 

Range of Values 

Default 

Units 

<address> 

numeric 

(DIAG:NRAM:ADDR?) 

none 


Comments 

- Be certain that address specifies the starting address of the area in user 
RAM (allocated using DIAG:NRAM:CREate) where you stored the 
commander/servant hierarchy table. 

- Tables must start on an even address. Note that DIAG:NRAM:CREate 
allocates RAM for the table with an even starting address. 
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- <address> may be specified in decimal, hex (#H), octal (#Q), or binary (#B) 
formats. 

- Setting address to 0 (zero) prevents the parameters defined by the table 
from being invoked when the system is rebooted, however, the table 
remains in user RAM. 

- For more information see “ User-Defined Commander/Servant 
Hierarchies”. 

- Related Commands: DIAGnostic:NRAM:CREate, 
DIAGnostic:NRAM:ADDRess?, DIAGnostic:DOWNload, VXI:CONF:CTABle? 

Example 

Link a Commander/Servant Hierarchy Table to the Processor 

DIAG:NRAM:CRE <size> Allocate space for table in user RAM. 

DIAG:BOOT Reboot system to complete allocation. 

DIAG:NRAM:ADDR? Get starting address of table (RAM segment). 

DIAG:DOWN <address>,<data> Download data into table. 
VXI:CONF:CTABle <address> Link table to processor. 

DIAG:BOOT Reboot system to implement table. 

:CONFigure:CTAB[e? 

VXI:CONFigure:CTABle? returns the starting address of the user’s 
commander/servant hierarchy table. 

Example 

Query Address of the Commander/Servant Hierarchy Table 

VXI:CONF:CTABle? Ask for address, 

enter statement Return address. 
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:CONFigure:DCTab[e 

VXI:CONFigure:DCTab[e <address> links a user-defined dynamic configuration 
table to the command module (resource manager) processor. The command 
module must be the acting resource manager in order for the table to be 
implemented. 

Parameters 


Parameter 

Name 

Parameter 

Type 

Range of Values 

Default 

Units 

<address> 

numeric 

(DIAG:NRAM:ADDR?) 

none 


Comments 

- Be certain that address specifies the starting address of the area in user 
RAM (allocated using DIAG:NRAM:CREate) where you stored the dynamic 
configuration table data. 

- Tables must start on an even address. Note that DIAG:NRAM:CREate 

- allocates RAM for the table with an even starting address. 

- <address> may be specified in decimal, hex (#H), octal (#Q), or binary (#B) 
formats. 

- Setting address to 0 (zero) prevents the parameters defined by the table 
from being invoked when the system is rebooted, however, the table 
remains in user RAM. 

- For more information see “ User-Defined Dynamic Configuration”. 

- Related Commands: DIAG:NRAM:CREate, DIAG:NRAM:ADDRess?, 
DIAG:DOWNload, VXI:CONF:DCTable? 

Example 

Link a Dynamic Configuration Table to the Processor 

DIAG:NRAM:CRE <size> Allocate space for table in user RAM. 

DIAG:BOOT Reboot system to complete the allocation. 

DIAG:NRAM:ADDR? Get starting address of table (RAM segment). 

DIAG:DOWN <address>,<data> Download data into table. 

VXI:CONF:DCTable <address> Link table to processor. 

DIAG:BOOT Reboot system to implement table. 
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:CON Figure: DCTabie? 

VXI:CONFigure:DCTab[e? returns the starting address of the user’s dynamic 
configuration table. 

Example 

Query Address of Dynamic Configuration Table 

VXI:CONF:DCTable? Ask for address, 

enter statement Return address. 

:CON Figure: DLADdress? 

VXI:CONFigure:DLADdress? returns a comma (,) separated decimal numeric list 
of device logical addresses currently installed in the mainframe. If the command 
module is not the resource manager, it only returns the logical addresses of the 
devices in its servant area. 

Comments 

- Use the VXI:CONF:DNUM? command to determine the number of values 
which will be returned by VXI:CONF:DLAD?. 

- Use each of the logical addresses returned by VXI:CONF:DLAD? with 
VXI:CONF:DLIS? to determine the types of devices installed. 

- VXI:CONF:DEVICELAD? is also accepted. 

- This command has been retained for compatibility with existing programs. 
For new programs you should use the VXI:CONF:LADDress? command. 

- Related Commands: VXI:CQNF:DLISt?, VXI:CQNF:DNUMber?, 
VXI:CQNF:LADDress? 

Example 

Determine the Device Addresses within the System 

VXI:CQNF:DLAD? Query for list of addresses, 

enter statement List of addresses. 
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:CONFigure:DLISt? 

VXI:CONFigure:DLISt? [<[ogicaLaddr>] returns information about the device 
specified by logicaLaddr. Response data is in the form: 
nl, n2, n3, n4, n5, n6, cl, c2, c3, c4, c5, si, s2, s3, s4 

Where the fields above are defined as: 

n fields Indicate numeric data response fields. 

0 fields Indicate character data response fields. 

s fields Indicate string data response fields. 

nl Device’s Logical Address. A number from 0 to 255. 

n2 Commander’s Logical Address. A number from -1 to 255; 

-1 means this device has no commander. 

n3 Manufacturer’s ID. A number from 0 to 4095. 

n4 Model Code. A number from 0 to 65535, chosen by the 
manufacturer to signify the model of this device. 

n5 Slot Number. A number between -1 and the number of slots in this 
mainframe; -1 indicates that the slot associated with this device is 
unknown. This is always -1 for B size mainframes. 

n6 Slot 0 Logical Address. A number from 0 to 255. 

cl Device Class. 3 data characters; EXT|HYB|MEM|MSG|REG|VME. 

EXT = Extended device, HYB = Hybrid device (e.g., IBASIC 
MEM = Memory device, MSG = Message-based device 
REG = Register-based device, VME = VME device 

c2 Memory Space. Up to 4 data characters; A16|A24|A32|NONE|RES. 

A16 = A16 addressing mode, A24 = A24 addressing mode, 

A32 = A32 addressing mode, NONE = no addressing mode, 

RES = reserved. 

c3 Memory Offset. 10 data characters which define the base address of 
the A24 or A32 address space on the device. This value is expressed 
in hex format (first two characters are #H). 

c4 Memory Size. 10 data characters which define the size of the A24 or 
A32 address space in bytes. This value is expressed in hex format 
(first two characters are #H). 

c5 Pass/Failed. Up to 5 data characters which define the status of the 
device; 

FAIL I IFAIL I PASS | READY. FAIL = failed self-test, 

IFAIL = configuration register initialization fails, 

PASS = self-test passed, 

READY = ready to receive commands 
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si Extended Field 1. Not currently used; returns "" s2 Extended Field 2. 
Not currently used; returns "" s3 Extended Field 3. Not currently 
used; returns "" 

s4 Manufacturer’s Specific Comments. Up to 80 character string 
contains manufacturer specific data in string response data format. 
This field is sent with a 488.2 string response data format, and will 
contain the instrument name and its IEEE 488.1 secondary address 
unless a start-up error is detected. In that case, this field will 
contain one or more error codes in the form "CNFG ERROR: n, m, 
...,z". Table B-3 in Appendix B for a complete list of these codes. 


Parameters 


Parameter 

Name 

Parameter 

Type 

Range of Values 

Default 

Units 

<[ogicaLaddr> 

numeric 

Oto 255 (or nothing) 

none 


Comments 

- When logicaLaddr is not specified, VXI:CONF:DLIS? returns information 
for each of the devices installed, separated by semicolons (;). If the 
command module is not the resource manager, it returns information on 
only the devices in its servant area. 

- Cards which are part of a combined instrument such as a switchbox or 
scanning voltmeter always return the same manufacturer’s comments as 
the first card in the instrument. Information in the other fields correspond 
to the card for which the logical address was specified. 

- This command has been retained for compatibility with existing programs. 
For new programs you should use the VXI:CONF:INF? and VXI:CONF:HIER? 
commands. 

- Related Commands: VXI:CONF:DLADdress?, VXI:CONF:DNUMber?, 
VXI:CONF:INFormation?, VXI:CONF:HIERarchy? 

Example 

Query the device list for the System Instrument 

dimension string[1000] string size large in case of multiple 

device list. 

VXI:CONF:DLIS? 0 Ask for the device list for the System instrument, 
enter string Enter return data into string. 
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Example response data (no error):+0, -1, +4095, +1301, +0, +0, HYB, 
NONE, #H00000000, #H00000000, READY, "SYSTEM INSTALLED 

AT SECONDARY ADDR 0" 

Example response data (with error):+255, +0, +4095, +65380, -1, +0, REG, 
A16, #H00000000, #H00000000, READY, "CNFG ERROR: 11" 

:CON Figure: DNUMber? 

VXI:CONFigure:DNUMber? returns the number of devices installed in the 
mainframe (including the System instrument itself). If the command module is 
not the resource manager, it returns the number of devices in its servant area. 

Comments 

- Use the VXI:CONF:DNUM? command to determine the number of values 
which will be returned by VXI:CONF:DLAD?. 

- This command has been retained for compatibility with existing programs. 
For new programs you should use the VXI:CONF:NUMBer? command. 

- Related Commands: VXI:CONF:DLADdress?, VXI:CONF:DLISt? 

Example 

Determine the Number of Devices Within the System 

VXI:CONF:DNUM? Query the number of devices. 

enter statement Input number of devices. 


:CONFigure:ETAB[e 

VXI:CONFigure:ETABle <address> links a user-defined extender table to the 
command module (resource manager) processor. The command module must be 
the acting resource manager in order for the table to be implemented. 

Parameters 


Parameter 

Name 

Parameter 

Type 

Range of Values 

Default 

Units 

<address> 

numeric 

(DIAG:NRAM:ADDR?) 

none 


Comments 

- Be certain that address specifies the starting address of the area in user 
RAM (allocated using DIAG:NRAM:CREate) where you stored the extender 
table. 
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- Tables must start on an even address. Note that DIAG:NRAM:CREate 
alloeates RAM for the table with an even starting address. 

- <address> may be specified in decimal, hex (#H), octal (#Q), or binary (#B) 
formats. 

- Setting address to 0 (zero) prevents the parameters defined by the table 
from being invoked when the system is rebooted, however, the table 
remains in user RAM. 

- For more information see the “ User-Defined Logical Address and Memory 
Windows”. 

- Related Commands: DIAG:NRAM:CREate, DIAG:NRAM:ADDRess?, 
DIAG:DOWNload, VXI:CONF:ETABle? 

Example 

Link an Extender Table to the Processor 

DIAG:NRAM:CRE <size> Allocate space for table in user RAM. 
DIAG:BOOT Reboot system to complete allocation. 

DIAG:NRAM:ADDR? Get starting address of table (RAM segment). 

DIAG:DOWN <address>,<data> Download data into table. 

VXI:CONF:ETAB <address> Link table to processor. 

DIAG:BOOT Reboot system to implement table. 

:CONFigure:ETAB[e? 

VXI:CONFigure:ETABle? returns the starting address of the user’s extender table. 

Example 

Query Address of the Extender Table 

VXI:CONF:ETABle? Ask for address, 

enter statement Return address. 


:CONFigure:HIERarchy? 

VXI:CONFigure:HIERarchy? returns current hierarchy configuration information 
about the selected logical address. The individual fields of the response are 
comma separated. If the information about the selected logical address is not 
available from the destination device (that is, the requested device is not in the 
mainframe or the command module’s servant area) then Error -224, "Illegal 
parameter value" will be set and no response data will be sent. 
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Comments 

- This command returns the following values: 

Logical address: An integer between -1 and 255 inclusive. 

-1 indicates that the device has no logical address. 

Commander’s logical address: An integer between -1 and 255 inclusive. -1 
indicates that the device has no commander or that the commander is 
unknown. 

Interrupt handlers: A comma (,) separated list of seven integers between 0 
and 7 inclusive. Interrupt lines 1 -7 are mapped to the individual return 
values. 0 (zero) is used to indicate that the particular interrupt handier is 
not configured. A set of return values of 0,0,0,5,2,0,6 would indicate that: 

— handier 4 is configured to handle interrupts on line 5 

— handier 5 is configured to handle interrupts on line 2 

— handier 7 is configured to handle interrupts on line 6 

— handlers 1, 2, 3, and 6 are not configured 

Interrupters: A comma (,) separated list of seven integers between 0 and 7 
inclusive. Interrupt lines 1 -7 are mapped to the individual return values. 0 
(zero) indicates that the particular interrupter is not configured. A set of 
return values of 0,0,0,5,2,0,6 would indicate that: 

— interrupter 4 is configured to handle interrupts on line 5 

— interrupter 5 is configured to handle interrupts on line 2 

— interrupter 7 is configured to handle interrupts on line 6 

— interrupters 1, 2, 3, and 6 are not configured 

Pass/Failed: An integer which contains the pass/faii status of the specified 
device encoded as follows: 

0 = FAIL, 1 = IFAIL, 2 = PASS, 3 = READY 

Manufacturer specific comment: Up to an 80 character quoted string that 
contains manufacturer specific data. It is sent with a 488.2 string response 
data format, and will contain the instrument name and its IEEE 488.1 
secondary address unless a start-up error is detected. In that case, this 
field will contain one or more error codes in the form "CNFG ERROR: n, m, 
...,z". See Table B-3 in Appendix B for a complete list of these codes. 

- Cards which are part of a combined instrument such as a switchbox or 
scanning voltmeter always return the same manufacturer’s comments as 
the first card in the instrument. Information in the other fields correspond 
to the card for which the logical address was specified. 

- Related Commands: VXI:SELect, VXI:CONF:HIERarchy:ALL?, 
VXI:CONF:LADDress? 
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:CON Figure: HI ERarchy:ALL? 

VXI:CONFigure:HIERarchy:ALL? returns the configuration information about all 
logical addresses in the mainframe, or the devices in the command module’s 
servant area if the command module is not the resource manager. The 
information is returned in the order specified in the response to 
VXI:CONF:LADDress?. The information about multiple logical addresses will be 
semicolon (;) separated and follow the IEEE 488.2 response message format. 
Individual fields of the output are comma (,) separated. 

Comments 

- Related Commands: VXhSELect, VXI:CONF:HIERarchy?, 
VXI:CONF:LADDress? 


:CON Figure: IN Formation? 

VXI:CONFigure:INFormation? returns the static information about the seleeted 
logical address (see VXhSELect). The individual fields of the response are comma 
(,) separated. If the information about the selected logical address is not 
available from the destination device (that is, the requested device is not in the 
mainframe or the command module’s servant area) then Error -224, "Illegal 
parameter value" will be set and no response data will be sent. The command 
returns the following values: 

Logical address: An integer between -1 and 255 inclusive. -1 indicates that 
the device has no logical address. 

Manufacturer ID: An integer between -1 and 4095 inclusive. -1 indicates that 
the device has no Manufacturer ID. 

Model code: An integer between -1 and 65535 inclusive. -1 indicates that 
the device has no model code. 

Device class: An integer between 0 and 5 inclusive. 

0 = VXIbus memory device, 1 = VXIbus extended device, 

2 = VXIbus message based device, 3 = VXIbus register-based device, 

4 = Flybrid device, 5 = Non-VXIbus device. 

Address space: An integer between 0 and 15 inclusive, which is the sum of 
the binary weighted codes of the address space(s) oecupied by the device. 
1 = The device has A16 registers, 2 = The device has A24 registers, 

4 = The device has A32 registers, 8 = The device has A64 registers. 

A16 memory offset: An integer between -1 and 65535 inclusive. Indicates 
the base address for any A16 registers (other than the VXIbus defined 
registers) which are present on the device. -1 indicates that the device has 
no A16 memory. 
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A24 memory offset: An integer between -1 and 16777215 inclusive. 
Indicates the base address for any A24 registers which are present on the 
device. -1 indicates that the device has no A24 memory. 

A32 memory offset: An integer between -1 and 4294967295 inclusive. 
Indicates the base address for any A32 registers which are present on the 
device. -1 indicates that the device has no A32 memory. 

A16 memory size: An integer between -1 and 65535 inclusive. Indicates the 
number of bytes reserved for any A16 registers (other than the VXIbus 
defined registers) which are present on the device. -1 indicates that the 
device has no A16 memory. 

A24 memory size: An integer between -1 and 16777215 inclusive. Indicates 
the number of bytes reserved for any A24 registers which are present on 
the device. -1 indicates that the device has no A24 memory. 

A32 memory size: An integer between -1 and 4294967295 inclusive. 
Indicates the number of bytes reserved for any A32 registers which are 
present on the device. -1 indicates that the device has no A32 memory. 

Slot number: An integer between -1 and the number of slots which exist in 
the cage. -1 indicates that the slot which contains this device is unknown. 

SlotO logical address: An integer between -1 and 255 inclusive. 

-1 indicates that the Slot 0 device associated with this device is unknown. 

Subclass: An integer representing the contents of the subclass register. 

-1 indicates that the subclass register is not defined for this device. 

Attribute: An integer representing the contents of the attribute register. 

-1 indicates that the attribute register is not defined for this device. 

Manufacturer specific comment: Up to an 80 character quoted string that 
contains manufacturer specific data. It is sent with a 488.2 string response 
data format, and will contain the instrument name and its IEEE 488.1 
secondary address unless a start-up error is detected. In that case, this 
field will contain one or more error codes in the form "CNFG ERROR: n, 
m,...,z". See Table B-3 in Appendix B for a complete list of these codes. 

Comments 

- Related Commands: VXLSELect, VXI:CONF:INFormation:ALL?, 
VXI:CONF:LADDress? 

Example 

Get Static Information on the Currently Selected Logical Address 

VXLSEL 0 Select the logical address. 

VXI:CONF:INF? Ask for data. 

enter statement Return data. 
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:CON Figure: IN Formation:ALL? 

VXI:CONFigure:INFonnation:ALL? returns the static information about ail logical 
addresses. The information is returned in the order specified in the response to 
VXI:CONF:LADDress?. The information about multiple logical addresses will be 
semicolon (;) separated and follow the IEEE 488.2 response message format. 
Individual fields of the output are comma (,) separated. 

Comments 

- Related Commands: VXhSELect, VXI:CONF:INFormation?, 
VXI:CONF:LADDress? 


:CONFigure:ITAB[e 

VXI:CONFigure:ITABle <address> links a user-defined interrupt line allocation 
table to the command module (resource manager) processor. The command 
module must be the acting resource manager in order for the table to be 
implemented. 

Parameters 


Parameter 

Name 

Parameter 

Type 

Range of Values 

Default 

Units 

<address> 

numeric 

(DIAG:NRAM:ADDR?) 

none 


Comments 

- Be certain that address specifies the starting address of the area in User 
RAM (allocated using DIAG:NRAM:CREate) where you stored the interrupt 
line allocation table data. 

- Tables must start on an even address. Note that DIAG:NRAM:CREate 
allocates RAM for the table with an even starting address. 

- <address> may be specified in decimal, hex (#FI), octal (#Q), or binary (#B) 
formats. 

- Setting address to 0 (zero) prevents the parameters defined by the table 
from being invoked when the system is re-booted, however, the table 
remains in user RAM. 

- For more information see the section “ User-Defined Interrupt Line 
Allocation Table”. 

- Related Commands: DIAG:NRAM:CREate, DIAG:NRAM:ADDRess?, 
DIAG:DOWNload, VXI:CONF:ITABle? 
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Example 

Link an Interrupt Line Allocation Table to the Processor 

DIAG:NRAM:CRE <size> Allocate space for table in user RAM. 

DIAG:BOOT Reboot system to complete the allocation. 

DIAG:NRAM:ADDR? Get starting address of table (RAM segment). 

DIAG:DOWN <address>,<data> Download data into table. 

VXI:CONF:ITAB <address> Link table to processor. 

DIAG:BOOT Reboot system to implement. 

:CONFigure:ITAB[e? 

VXI:CONFigure:ITABle? returns the starting address of the user’s interrupt line 
allocation table. 

Example 

Query Address of Interrupt Line Allocation Table 

VXI:CONF:ITABle? Ask for address. 

enter statement Return address. 


:CON Figure: LADDress? 

VXI:CONFigure:LADDress? returns a comma (,) separated list of logical addresses 
of devices in the mainframe, or a list of devices in the command module’s servant 
area if the command module is not the resource manager. This is an integer 
between 1 and 256 inclusive. The logical address of the device responding to the 
command will be the first entry in the list. If the command is received by a device 
other than the resource manager, the response will contain the logical address of 
the destination device followed by a list of devices which are immediate servants 
to the destination device. 

Comments 

- Related Commands: VXLSFLect, VXI:CONF:NUMBer? 
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:CON Figure: LADDress:MEXTender? 

VXI:CONFigure:LADDress:MEXTender? returns a comma (,) separated list of 
logical addresses of mainframe extender devices in the system. This is an integer 
between 1 and 256 inclusive. If there are no extender devices in the system a -1 
will be returned. An error is reported if the command is received by a device other 
than the resource manager. 

Comments 

- Related Commands: VXhSELect, VXI:CONF:NUMBer:MEXTender? 


:CONFigure:MEXTender:ECLTrg<n> 

VXI:CONFigure:MEXTender:ECLTrg<n> <direction> is used to configure the 
selected mainframe extender to direct the ECL trigger specified by <n>. 

Parameters 


Parameter 

Name 

Parameter 

Type 

Range of Values 

Default 

Units 

<n> 

numeric 

Oorl 

none 

<direction> 

discrete 

IN 1 OUT 1 NONE 

none 


Comments 

- Select the logical address of the extender to access with the VXhSELect 
command. 

- The trigger line affected is specified in the ECLTrg<n> node of the 
command by an integer of 0 or 1. Integers greater than 1 will generate 
Error-113, "Undefined header". 

- A mainframe extender can direct a trigger line into or out of the VXIbus 
card cage (mainframe) that it is plugged into. 

- If you specify NONE the trigger line will be disabled and will not be 
directed in or out. 

- Some mainframe extender devices do not support some trigger lines. 
These commands will determine whether the specified trigger line is 
supported before it attempts to execute the command. If the trigger line is 
not supported a "trigger not supported" error will be returned. 

- This command can only be executed by the System instrument in a 
command module that is serving as resource manager for the entire 
VXIbus system. 
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- Related Commands: VXI:CONF:MEXTender:INTerrupt, 
VXI:CONF:MEXTender:TTLTrg<n>, VXI:ROUTe:ECLTrg<n> 

Example 

Direct ECL trigger line 1 from a card cage with "child side" extender at logical 
address 5 to an extended card cage with a "parent side extender" of logical 
address 6. 

VXLSEL 5 Select logical address 5. 

VXI:CONF:MEXT:ECLTl OUT Configure the logical address 5 

extender as OUT. 

VXLSEL 6 Select logical address 6. 

VXI:CONF:MEXT:ECLTl IN Configure the logical address 6 

extender as IN. 


:CON Figure: MEXTender: I NTerrupt<n> 

VXI:CONFigure:MEXTender:INTerrupt<n> <direction> is used to configure the 
selected mainframe extender to direct the interrupt line specified by <n>. 

Parameters 


Parameter 

Name 

Parameter 

Type 

Range of Values 

Default 

Units 

<n> 

numeric 

Oorl 

none 

<direction> 

discrete 

IN 1 OUT 1 NONE 

none 


Comments 

- Select the logical address of the extender to access with VXLSELect. 

- The interrupt line affected is specified in the INTerrupt<n> node of the 
command by a number ranging from 1 to 7. Numbers less than 1 and 
greater than 7 will generate Error -113, "Undefined header". 

- A mainframe extender can direct an interrupt line into the VXIbus card 
cage (mainframe) that it is plugged into or it can direct the interrupt line 
out of the card cage. 

- If you specify NONE the interrupt line will be disabled and will not be 
directed in or out. 
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- Some mainframe extender devices do not support directing interrupt lines. 
These commands will determine whether the specified interrupt line is 
supported before it attempts to execute the command. If the interrupt line 
is not supported, a trigger not supported error will be returned. 

- This command can only be executed by the System instrument in a 
command module that is serving as resource manage for the entire VXIbus 
system. 

- Related Commands: VXI:CONF:MEXTender:ECLTrg<n>, 
VXI:CONF:MEXTender:TTLTrg<n>, VXI:ROUTe:INTerrupt<n> 


Example 

Direct interrupt line 1 from a card cage with "child side" extender at logical 
address 5 to an extended card cage with a "parent side extender" of logical 


address 6. 

VXI:SEL5 

VXI:CONF:MEXT:INTl OUT 

VXI:SEL6 

VXI:CONF:MEXT:INTl IN 
as IN. 


Select logical address 5. 

Configure the logical address 5 extender 
as OUT. 

Select logical address 6. 

Configure the logical address 6 extender 


:CONFigure:MEXTender:TTLTrg<n> 

VXI:CONFigure:MEXTender:TTLTrg<n> <direction> is used configure the 
selected mainframe extender to direct the TTL trigger specified by <n>. 

Parameters 


Parameter 

Name 

Parameter 

Type 

Range of Values 

Default 

Units 

<n> 

numeric 

0 through 1 

none 

<direction> 

discrete 

IN 1 OUT 1 NONE 

none 


Comments 

- Select the logical address of the extender to access with VXLSELect. 

- The trigger line affected is specified in the TTLTrg<n> node of the 
command by a number ranging from 0 to 7. Numbers greater than 7 will 
generate Error-113, "Undefined header". 
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- A mainframe extender can direct a trigger line into the VXIbus card cage 
(mainframe) that it is plugged into or it can direct the trigger line out of the 
card cage. 

- If you specify NONE the trigger line will be disabled and will not be 
directed in or out. 

- Some mainframe extender devices do not support some trigger lines. 
These commands will determine whether the specified trigger line is 
supported before it attempts to execute the command. If the trigger line is 
not supported, a "trigger not supported" error will be returned. 

- This command can only be executed by the System instrument in a 
command module that is serving as resource manager for the entire 
VXIbus system. 

- Related Commands: VXI:CONF:MEXTender:INTerrupt<n>, 
VXI:CONF:MEXTender:ECLTrg<n>, VXI:ROUTe:TTLTrg<n> 


Example 

Direct TTL trigger line 1 from a card cage with "child side" extender at logical 
address 5 to an extended card cage with a "parent side extender" of logical 


address 6. 

VXI:SEL5 

VXI:CONF:MEXT:TTLTl OUT 

VXI:SEL6 

VXI:CONF:MEXT:TTLTl IN 


Select logical address 5. 

Configure the logical address 5 extender 
as OUT. 

Select logical address 6. 

Configure the logical address 6 extender 
as IN. 


:CONFigure:MTAB[e 

VXI:CONFIgure:MTABle <address> links a user-defined A24/A32 address 
allocation table to the command module (resource manager) processor. The 
command module must be the acting resource manager in order for the table to 
be implemented. 

Parameters 


Parameter 

Name 

Parameter 

Type 

Range of Values 

Default 

Units 

<address> 

numeric 

(DIAG:NRAM:ADDR?) 

none 
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Comments 

- Be certain that address specifies the starting address of the area in user 
RAM (allocated using DIAG:NRAM:CREate) where you stored the A24/A32 
address allocation table data. 

- Tables must start on an even address. Note that DIAG:NRAM:CREate 
allocates RAM for the table with an even starting address. 

- <address> may be specified in decimal, hex (#H), octal (#Q), or binary (#B) 
formats. 

- Setting address to 0 prevents the parameters defined by the table from 
being invoked when the system is rebooted, however, the table remains in 
user RAM. 

- For more information see “ Reserving A24/A32 Address Space”. 

- Related Commands: DIAG:NRAM:CREate, DIAG:NRAM:ADDRress?, 
DIAG:DOWNload, VXI:CONF:MTABle? 

Example 

Link an A24/A32 Address Allocation Table to the Processor 

DIAG:NRAM:CRE <size> Allocate space for table in user RAM. 

DIAG:BOOT Reboot system to complete the allocation. 

DIAG:NRAM:ADDR? Get starting address of table 

(RAM segment). 

DIAG:DOWN <address>,<data> Download data into table. 

VXI:CONF:MTAB <address> Link table to processor. 

DIAG:BOOT Reboot system to implement table. 

:CONFigure:MTABle? VXI:CONFigure:MTABle? returns the 

starting address of the user’s A24/A32 address allocation table. 

Example 

Query Address of A24/A32 Address Allocation Table 

VXI:CONF:MTABle? Ask for address, 

enter statement Return address. 
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:CONFigure:NUMBer? 

VXI:CONFigure:NUMBer? returns the number of devices in the system when it is 
issued to a resource manager. This is an integer between 1 and 256 inclusive. If 
the command is received by a device that is not the resource manager, it returns 
the number of devices which are immediate servants to the destination device, 
including the destination device. For example, a commander with 3 servants 
would return a value of 4, or a resource manager for a system of 4 devices would 
return a value of 5. 

Comments 

- Related Commands: VXLSELect, VXI:CONF:LADDress? 


:CON Figure: NUMBeriMEXTender? 

VXI:CONFigure:NUMBer:MEXTender? returns the number of devices in the 
system when it is issued to a resource manager. This is an integer between 1 and 
256 inclusive, which indicates the number of mainframe extender devices in the 
system. If the command is received by a device other than the resource manager 
an error is reported. 

Comments 

- Related Commands: VXLSELect, VXI:CONF:LADDress?, 
VXI:CONF:NUMBer? 


:QUERy? 


VXLQUERy? <logical_addr> returns one 16-bit data word from the Data Low 
Register of the message-based device at logical_addr. 

Parameters 


Parameter 

Name 

Parameter 

Type 

Range of Values 

Default 

Units 

<[ogica[_addr> 

numeric 

Must round to 0 through 255. 

none 


Comments 

- Send a Device Clear to "unlock" the System instrument in case the device 
at logicaLaddr does not respond. 

- VXLQUERy? can be used to read the response in the Data Low Register 
when the VXLSEND:COMM command is ANY, and the command sent is a 
query. 
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- This command has been retained for compatibility with existing programs. 
For new programs you should use VXI:WSP:RESP? 

- Related Commands: VXI:SEND:COMMand, VXI:WSProtocoi:RESP? 

Example 

Read the Data Low Register of Device at Logical Address 72 

VXliQUERY? 72 Query value of Data Low Register, 

enter statement Input 16-bit value. 


:READ? 


VXI:READ? <iogicaLaddr>, <register_addr> allows access to the entire 64-byte 
A16 register address space for the device specified by iogicaLaddr. Since the 
VXIbus system is byte-addressed, while the registers are 16-bits wide, registers 
are specified by even addresses only. This method of identifying registers follows 
the VXIbus standard format. 

Parameters 


Parameter 

Name 

Parameter 

Type 

Range of Values 

Default 

Units 

<[ogicaLaddr> 

numeric 

Must round to 0 through 255. 

none 

<register_addr> 

numeric 

Must round to an even value from 

0 through 62 (3Eh). 

none 


Comments 

- Specifying an odd register address will cause Error +2003, "Invalid word 
address". 

- Specifying a logical address not currently in the system will cause Error 
+2005, "No card at logical address". 

- If the command module is the resource manager it can read from any 
device within the mainframe. If the command module is not the resource 
manager it can only read from devices within its servant area. 

- <iogicaLaddr> must be specified in decimal. <register_addr> may be 
specified in decimal, hex (#H), octal (#Q), or binary (#B). 

- Accesses are 16-bit non-priviieged data accesses. 

- This command has been retained for compatibility with existing programs. 
For new programs you should use VXI:REG:READ?. 

- Related Commands: VXI:WRITe, VXI:REGister:READ? 
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Example 

Read from One of a Device’s Configuration Registers 

VXLREAD? 8,0 Read ID Register on device at logical 

address 8. 

enter statement Enter value from Device Register. 

:RECeive[:MESSage]? 

VXI:RECeive[:MESSage]? <logical_addr>[,<end_of_msg>] receives a message 
from the message-based device at logical_addr. 

Parameters 


Parameter 

Name 

Parameter 

Type 

Range of Values 

Default 

Units 

<[ogica[_addr> 

numeric 

Must round to 0 through 255. 

none 

<end_of_msg> 

discrete/numeri 

c 

END |LF| CRLF |<count> 

none 


Comments 

- A message ends when the condition specified by the end_of _msg 
parameter is met. When end_of_msg specifies a count, it can range from 1 
through 2,147,483,647. 

- The default end_of_msg parameter is END. 

- VXLREC? together with VXhSEND can be used to communicate with 
message-based devices from an RS-232 monitor via the command 
module. If the command module is the resource manager, the 
message-based devices can be inside or outside its servant area. If the 
command module is not the resource manager, the message-based 
devices must be in the command module’s servant area. 

- VXLREC? uses the Byte Transfer Protocol which uses the DIR and DDR bits 
In the Response Register. This protocol and DIR/DOR are described in the 
VXIbus System Specifications. 

- Send a Device Clear to "unlock" the System instrument in case the device 
at logicaLaddr does not satisfy the end_of_msg condition (insufficient data 
for count, or no END | LF | CRLF). 

- This command has been retained for compatibility with existing programs. 
For new programs you should use the VXI:WSP:MESS:REC? command 

- Related Commands: VXI:SEND[:MESSage], 
VXI:WSProtocol:MESSage:RECeive?, VXI:WSProtocol:MESSage:SEND 
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Example 

Query for Message from Module at Logical Address 16 

VXLSEND 16,"*IDN?" Send command to device at logical 

address 16. 

VXLREC? 16 Enter message. 

:REGister:READ? 

VXI:REGister:READ? <register> returns the contents of the specified 16-bit 
register at the selected logical address as an integer (see VXLSELect). 

Parameters 


Parameter 

Name 

Parameter 

Type 

Range of Values 

Default 

Units 

<register> 

numeric 

Even numbers from 0 to 62 or 
register name (see below). 

none 


Comments 

- The register parameter can be all even numbers from 0 to 62 inclusive (as a 
numeric value) or the following (optional) words: 

A16 Window: A16 Window Map Register (12) 

A24Low: A24 Pointer Low Register (18) 

A24High: A24 Pointer High Register (16) 

A24 Window: A24 Window Map Register (14) 

A32Low: A32 Pointer Low Register (22) 

A32High: A32 Pointer High Register (20) 

A32 Window: A32 Window Map Register (16) 

ATTRibute: Attribute Register (8) 

DHIGh: Data High Register (12) 

DLOW: Data Low Register (14) 

DTYPe: Device Type Register (2) 

ETConfigure: ECL Trigger Configuration Register (22) 

ICNF: Interrupt Configuration Register (18) 

ICQNtrol: Interrupt Control Register (28) 

ID: ID Register (0) 

ISTatus: Interrupt Status Register (26) 

LAWindow: Logical Address Configuration Register (10) 

TTConfigure: TTL Trigger Configuration Register (20) 

MQDid: MQDID Register (8) 

QFFSet: Qffset Register (6) 

PRQTocol: Protocol Register (8) 
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RESPonse: Response Register (10) 

SNHigh: Serial Number High Register (10) 
SNLow: Serial Number Low Register (12) 
status: Status Register (4) 

SUBClass: Subclass Register (30) 

UCONfigure: Utility Configuration Register (24) 
VNUMber: Version Number Register (14) 


NOTE 


The optional register names are decoded into the equivalent 
register address. You will get correct results if you use any one of 
the words for a given register address, even if the word itself does 
not make sense for the device you are using. 


- Related Commands: VXLSELect, VXI:REGister:WRITe 

Example 

Read from a Register on the Currently Selected Device 

VXLREAD? ICON Read from the Interrupt Control Register 

of the ourrently seleoted devioe. 


iREGisterWRITe 

VXLREGistenWRITe <register>, <data> writes data to the specified 16-bit 
register at the selected logical address (see VXLSELect). 

Parameters 


Parameter 

Name 

Parameter 

Type 

Range of Values 

Default 

Units 

<register> 

numeric 

Even numbers from 0 to 62 or 
register name (see below). 

none 

<data> 

numeric 

-32768 to 32767 

none 


Comments 

- The register parameter can be all even numbers from 0 to 62 inclusive (as a 
numeric value) or the following (optional) words: 

A16 Window: A16 Window Map Register (12) 

A24 Window: A24 Window Map Register (14) 

A32 Window: A32 Window Map Register (16) 

CONTrol: Control Register (4) 

DEXTended: Data Extended Register (10) 
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DHIGh: Data High Register (12) 

DLOW: Data Low Register (14) 

ETConfigure: ECL Trigger Configuration Register (22) 
iCNF: interrupt Configuration Register (18) 
iCONtroi: interrupt Control Register (28) 

LAWindow: Logical Address Configuration Register (10) 
MODid: MODiD Register (8) 

LADDress: Logical Address Register (0) 

OFFSet: Offset Register (6) 

SiCNal: Signal Register (8) 

TTConfigure: TTL Trigger Configuration Register (20) 
UCONfigure: Utility Configuration Register (24) 


NOTE 


The optional register names are decoded into the equivalent 
register address. You will get correct results if you use any one of 
the words for a given register address, even if the word itself does 
not make sense for the device you are using. 


- Related Commands: VXi:SELect, VXi:REGister:READ? 

Example 

Write to a Register on the Currently Selected Device 

VXi:REG:WRiT DHiG,64 Writes "64" to Data High Register. 

:RESet 

VXi:RESet <logical_addr> performs a soft reset of the device at logical_addr. 

Parameters 


Parameter 

Name 

Parameter 

Type 

Range of Values 

Default 

Units 

<[ogica[_addr> 

numeric 

Must round to 0 through 255. 

none 


Comments 

- VXi:RESet sets the Sysfail inhibit bit in the device’s Control Register, then 
sets the Reset bit, waits 100?s, then clears Reset. When the device has 
passed its self-test, Sysfail inhibit is cleared, if the device fails during the 
reset (does not assert "Passes" within 4.9 sec), Sysfail inhibit remains 
asserted. 
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- If the command module is the resource manager, it can reset any device 
within the mainframe. If the command module is not the resource 
manager, it can only reset devices within its servant area. You cannot use 
VXI:RESet to reset the command module (use DIAG:BOOT). 

- When a device is reset, the command module (system instrument) will 
write 1 ’s to the device dependent bits in the device’s Control Register. 

- This command has been retained for compatibility with existing programs. 
For new programs you should use VXI:RESet?. 

Example 

Reset a VXIbus Device 

VXI:RES 64 Reset device at logical addr 64. 


:RESet? 


VXI:RESet? resets the selected logical address. SYSFAIL generation is inhibited 
while the device is in the self-test state. The command waits for 5 seconds or 
until the selected device has indicated passed (whichever occurs first). If the 
device passes its self-test, the SYSFAIL generation is re-enabled. If the device 
fails the self-test, then SYSFAIL generation will remain inhibited. 

Comments 

- The return value from this command is the state of the selected device 
after it has been reset. The command returns a <NR1 > encoded as follows: 
0 = FAIL, 2 = PASS, 3 = READY 

- The state of the A24/A32 enable bit is not altered by this command. 

- If the command module is the resource manager, it can reset any device 
within the mainframe. If the command module is not the resource 
manager, it can only reset devices within its servant area. You cannot use 
VXI:RESet? to reset the command module (use DIAG:BOOT). 

- Related Commands: VXI:SELect 


:ROUTe:ECLTrg<n> 

VXI:ROUTe:ECLTrg<n> configures the routing of the ECL trigger line specified by 
<n> for all mainframe extenders in the system. 

Parameters 


Parameter 

Name 

Parameter 

Type 

Range of Values 

Default 

Units 

<n> 

numeric 

Oorl 

none 


250 


Keysight E1406A User Manual and SCPI Programing Guide 




VXI Subsystem 


Keysight El 406A Command Reference 


Comments 

- The routing is set so the device selected by the VXLSELect command can 
source the trigger line and all other devices in the system may monitor that 
trigger line. 

- Some mainframe extender devices do not support some trigger lines. This 
command will determine whether the specified trigger line is supported 
while it attempts to execute the command and return a trigger not 
supported error if it encounters any extenders that do not support the 
specified trigger. It will attempt to direct all extenders that do support the 
specified trigger, even if it encounters some extenders that do not. 

- This command can only be executed by the System instrument in a 
command module that is serving as resource manager for the entire 
VXIbus system. 

- Related Commands: VXLSELect, VXI:ROUTe:TTLTrg<n>, 
VXI:ROUTe:INTerrupt<n>, VXI:CONFigure:MEXTender? 

:ROUTe:INTerrupt<n> 

VXI:ROUTe:INTerrupt<n> configures the routing of the interrupt line specified by 
<n> for all mainframe extenders in the system. 

Parameters 


Parameter 

Name 

Parameter 

Type 

Range of Values 

Default 

Units 

<n> 

numeric 

0 through 7 

none 


Comments 

- The routing is set so the device selected by the VXLSELect command can 
handle the interrupt line and all other devices in the system may assert 
that interrupt line. 

- Some mainframe extender devices do not support directing interrupt lines. 
This command will determine whether the specified interrupt line is 
supported while it attempts to execute the command and return a trigger 
not supported error if it encounters any extenders that do not support the 
specified line. It will attempt to direct all extenders that do support the 
specified line, even if it encounters some extenders that do not. 

- This command can only be executed by the System instrument in a 
command module that is serving as resource manager for the entire 
VXIbus system. 

- Related Commands: VXLSELect, VXLROUTe:TTLTrg<n>, 
VXLROUTe:ECLTrg<n>, VXLCONFigure:MEXTender 
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:ROUTe:TTLTrg<n> 

VXI:ROUTe:TTLTrg<n> configures the routing of the TTL trigger line specified by 
<n> for ail mainframe extenders in the system. 

Parameters 


Parameter 

Name 

Parameter 

Type 

0 

Range of Values 

Default 

Units 

<n> 

numeric 

0 through 7 

none 


Comments 

- The routing is set so the device selected by the VXLSELect command can 
source the trigger line and all other devices in the system may monitorthat 
trigger line. 

- Some mainframe extender devices do not support some trigger lines. This 
command will determine whether the specified trigger line is supported 
while it attempts to exeoute the eommand and return a trigger not 
supported error if it enoounters any extenders that do not support the 
specified trigger. It will attempt to direct all extenders that do support the 
specified trigger, even if it encounters some extenders that do not. 

- This command can only be exeeuted by the System instrument in a 
command module that is serving as resource manager for the entire 
VXIbus system. 

- Related Commands: VXLSELect, VXI:ROUTe:INTerrupt<n>, 
VXI:ROUTe:ECLTrg<n>, VXI:CONFigure:MEXTernal? 


iSELect 


VXLSELect <logical_addr> specifies the logical address to be used by many 
subsequent commands in the VXI subsystem. 

Parameters 


Parameter 

Name 

Parameter 

Type 

Range of Values 

Default 

Units 

<logicaLaddr> 

numeric 

Must round to 0 through 255. 

none 
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Comments 

- The *RST default value for logical_addr is that no logical address is 
selected (i.e., -1). All other commands which require a logical address to 
be selected will respond with Error -221, "Settings conflict", if no 
instruments logical address is selected. 

- When a command encounters an Error -240, "Hardware error", the 
equivalent of a *RST is executed. This will cause the selected logical 
address to be set to -1. 

- Related Commands: VXI:CONFigure:LADDress? 

Example 

Select a Logical Address 

VXLSEL 64 Sets the logical address to be used by 

subsequent VXI subsystem commands to 64. 


iSELect? 


VXLSELect? returns the logical address which will be used by many subsequent 
commands in the VXI subsystem. If no logical address has been selected, this 
query will return -1. 
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:SEND:COMMand 

VXI:SEND:COMMand <[ogicaLaddr>,<command>[,<data>] sends the specified 
word serial command (and optional data) to logical_addr. 

Parameters 


Parameter 

Name 

Parameter 

Type 

Range of Values 

Default 

Units 

<[ogicaLaddr> 

numeric 

Must round to 0 through 255. 

none 


The command field and any required data fields are specified in the table below. 


<command> 

<data> 

Description 

BAVailable 

<byte>(0-511) 

Byte Available 

(bit 8 = 1= END, bits 7-0 = data byte) 

CLEar 


Clear 

CLOCK 


Clear LocK 

GDEVice 

<devicejaddr>(0 - 255) 

Grant Device 

ICOMmander 

<cmdr_[addr>(0 - 255) 

Identify Commander 

SLOCK 


Set Lock 

TRIGger 


Trigger 

ANY 

<cmd_word> 

Specify any word serial command as a 16-bit 
value in cmd_word. Read response from the 

Data Low Register using VXLQUERy?. 


Comments 

- <data> may be specified in decimal, hex (#H), octal (#Q), or binary (#B) 
formats. 

- VXI:SEND:COMMand uses the Word Serial Transfer Protocol. This protocol 
is described in the VXIbus System Specifications. 

- VXI:SEND:COMMand is recommended for use with devices conforming to 
VXIbus System Specifications, revision 1.3 or later. 

- This command has been retained for compatibility with existing programs. 
For new programs you should use VXI:WSP:COMM. 

- Related Commands: VXI:SEND:COMMands?, VXI:WSProtocol:COMMand, 
VXI:WSProtocol:QUERy? 

Example 

Send 1 Data Byte to Logical Address 241 

VXI:SEND:COMM 241,BAV,452 End bit = 1 and data byte is 196. 


254 


Keysight E1406A User Manual and SCPI Programing Guide 





VXI Subsystem 


Keysight El 406A Command Reference 


:SEND:COMMand? 

VXI:SEND:COMMand <[ogicaLaddr>,<command>[,<datal >[,<data2>]] sends 
the specified word serial command (and optional dataN values) using the 
word-serial protocol, to the module at logical_addr. It then waits for and returns 
a 16-bit response value. 

Parameters 


Parameter Name 

Parameter Type 

Range of Values 

Default Units 

<[ogica[_addr> 

numeric 

Must round to 0 through 255. 

none 
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The command field and any required data fields are specified in the following 
table. 


1 <command> 

<data1> 

<data2> 

Description I 

AHLine 

<handjd> (1 - 7) 

<[ine_#> (0-7) 

Assign Handler Line. A line number of 0 
means the handler is to be disconnected. 

AILine 

<intjd> (1 - 7) 

<[ine_#> (0-7) 

Assign Interrupter Line. A line number of 0 
means the handler is to be disconnected. 

AM Control 

<rspns_mask> 

(0-15)' 

<event_#> (0 -127) 

Asynchronous Mode Control 

ANO 



Abort Normal Operation 

ANY 

<cmd_word> 


Specify any VXIbus command 


(-32768 - 32767) 



BNO 

<top_[eve[> 

(01 non-zero) 


Begin Normal Operation 

BREQuest 



Byte Request 

CEVent 

<enab[e> 

(0|1 1 OFF ION) 


Control Event 

CRESponse 

<rspns_mask> 

(0-127) 


Control Response 

ENO 



End Normal Operation 

RDEVice 

<[ogica[_addr> 

(0 - 255) 


Release Device 

RHANdlers 



Read Handlers 

RHLine 

<handjd> (1 - 7) 


Read Handler Line 

RILine 

<intjd> (1 - 7) 


Read Interrupter Line 

RINTerrupter 



Read Interrupters 

RMODid 



Read MODID 

RPERror 



Read Protocol Error 

RPRotocol 

RSARea 



Read Protocol Read Servant Area 

RSTB 



Read STB 

SLModid 

<enab[e> 

(0|1 1 OFF ION) 

<modid> (0-127) 

Set Lower MODID (lines 0 - 6) 

SUModid 

<enab[e> 

(0|1 1 OFF ION) 

<modid> (0 - 63) 

Set Upper MODID (lines 7-12) 


Comments 

- <datal > and <data2> may be specified in decimal, hex (#H), octal (#Q), or 
binary (#B) formats. 

- VXI:SEND:COMMand uses the Word Serial Transfer Protocol. This protocol 
is described in the VXIbus System Specification Manual. 
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- VXI:SEND:COMMand? is recommended for use with devices conforming to 
VXIbus Specifications, revision 1.3 or later. 

- This command has been retained for compatibility with existing programs. 
For new programs you should use VXI:WSP:QUER? 

- Related Commands: VXI:SEND:COMMand, VXI:WSProtocol:QUERy? 

Example 

Read Which IRQ Line is Used by Interrupt Handler in Logical Address 241 

VXI:SEND:COMM? 241 ,RHLINE,2 Which line used by second handler 

in servant at 241. 

enter statement Return the number of the interrupt line. 


:SEND[:MESSage] 

VXI:SEND[:MESSage] <logical_addr>,"<msg_string>"[<end_flag>] sends the 
specified message string to the message based module at logical_addr. 

Parameters 


Parameter 

Name 

Parameter 

Type 

Range of Values 

Default 

Units 

<[ogica[_addr> 

decimal numeric 

Must round to 0 through 255. 

none 

<msg_string> 

string 

ASCII characters (no nulls) 

none 

<end_f[ag> 

discrete 

END 1NOENd 

none 


Comments 

- VXLREC? together with VXLSEND can be used to communicate with 
message-based devices from an RS-232 monitor via the command 
module. If the command module Is the resource manager, the 
message-based devices can be inside or outside its servant area. If the 
command module is not the resource manager, the message-based 
devices must be in the command module’s servant area. 

- VXLSEND uses the Byte Transfer Protocol which uses the DIR and DOR 
bits in the Response register. This protocol and DIR/DOR are described in 
the VXIbus System Specifications. 

- The last byte of msg_string is sent with the END bit set unless end_flag is 
specified as NOENd. 

- If CR or CRLF is to be sent, they must be included in msg_string. 

- Null characters (ASCII value 0) must not occur In msg_string. 
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- This command has been retained for compatibility with existing programs. 
For new programs you should use VX1:WSP:MESS:SEND. 

- Related Commands: VXI[:RECeive]:MESSage?, 
VXI:WSProtocol:MESSage:SEND, VXI:WSProtocol:MESSage:RECeive? 

Example 

Send a Message to a Message-Based Device at Logical Address 16 

VXLSEND 16,"MEAS:VOLT:DC?" Send command to message-based 

multimeter (last by is sent with END bit set). 

VXLREC? 16 Retrieve voltage measurement. 


:WRITe 


VXLWRITe <logical_addr>, <register_addr>,<data> allows access to the entire 
64-byte A16 register address space for the device specified by logical_addr. 
Since the VXIbus system is byte-addressed, while the registers are 16-bits wide, 
registers are specified by even addresses only. This method of identifying 
registers follows the VXIbus standard format. 

Parameters 


Parameter Name 

Parameter Type 

Range of Values 

Default Units 

<[ogica[_addr> 

decimal numeric 

Must round to 0 through 255. 

none 

<register_addr> 

numeric 

Must round to an even value from 

0 through 62 (3Eh). 

none 

<data> 

numeric 

Must round to -32768 to 32767 (0 
to FFFFh). 

none 


Comments 

- Specifying an odd register address will cause Error +2003, "Invalid word 
address". 

- Specifying a logical address not currently in use in the system will cause 
Error +2005, "No card at logical address". 

- If the command module is the resource manager, it can write to any device 
within the mainframe. If the command module is not the resource 
manager, it can only write to those devices within its servant area. 

- <logical_addr> must be specified in decimal. <register_addr> and <data> 
may be specified in decimal, hex (#H), octal (#Q), or binary (#B) format. 

- This command has been retained for compatibility with existing programs. 
For new programs you should use the VXI:REG:WRIT command. 
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- Accesses are 16-bit non-privileged data accesses. 

- Related Commands: VXkREAD?, VXI:REGister:WRITe 

Example 

Write a Value into a Device’s Device Dependent Register 

VXkWRIT 8,24,#H4200 Write hex 4200 (16,896 decimal) to 

register 24 of device at logical address 8. 
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:WSProtoco[:COMMand:command 

VXI:WSProtoco[:COMMand:command is a series of commands which sends the 
specified Word Serial Command to the address set using the VXhSELect 
command and continues without waiting for a response. The response to this 
command can be read with the VXLWSProtocoLRESPonse? command. The 
following table lists the available commands and their parameters (if any). 


:command 

parameterl 

parameter2 

Description 

:AHLine 

<handjd> (1-7) 

<[ine_#> (0-7) 

Assign Handler Line. A line number of 0 
means the handler is to be disconnected. 

:AILine 

<intjd> (1 - 7) 

<[ine_#>(0-7) 

Assign Interrupter Line. A line number of 0 
means the handler is to be disconnected. 

:AMContro[ 

:ANO 

<rspns_mask> (0-15) 


Asynchronous Mode Control 

Abort Normal Operation 

:ANY 

<cmd_word> 

(-32768 - 32767) 


Specify any word serial command as a 

16-bit value in cmd_word. 

iBAVailable 

<end_bit> 

(1 |0|OFF|ON) 


Byte Available 

(bit 8 = 1= END, bits 7 - 0 = data byte) 

:BNO 

iBREQuest 

<top_[eve[> 

(1 |0|OFF|ON) 


Begin Normal Operation 

Byte Request 

:CEVent 

<enab[e> 


Control Event 

:CLEar 

(0|1 1 OFF ION) 

<byte> (0 - 255) 

Clear 

:CLOCk 

<rspns_mask> (0 -127) 

<event_#> (0 - 

Clear Lock 

:CRESponse 

<cmdrjaddr> (0 - 255) 

127) 

Control Response 

:ENO 

<[ogica[_addr> (0 - 255) 


End Normal Operation 

:GDEVice 

<handjd> (1 - 7) 


Grant Device 

ilCOMmander 

<intjd> (1 - 7) 


Identify Commander Release Device Read 

iRDEVice 


<modid> (0-127) 

Handlers 

iRHANdlers 

<enab[e> 

<modid> (0 - 63) 

Read Handler Line Read Interrupter Line 

iRHLine 

(0|1 1 OFF ION) 


Read Interrupters Read MODID 

iRILine 

<enab[e> 


Read Protocol Error 

iRINTerrupter 

iRMODid 

iRPERror 

iRPRotocol 

iRSARea 

:RSTB 

:SLModid 

:SLOCk 

:SUModid 

TRIGger 

(0|1 1 OFF ION) 


Read Protocol Read Servant Area Read STB 
Set Lower MODID (lines 0 - 6) 

Set Lock 

Set Upper MODID (lines 7-12) 

Trigger 
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Comments 

- byte, cmd_word, event_number, handjd, intjd, [ine_number, 
logicaLaddress, modid, and response_mask may be specified in decimal, 
hex (#H), octal (#Q), or binary (#B) formats. 

- end_bit selects whether the END bit is set in the command. 

- topjevel selects whether the Topjevel bit is set in the command. 

- enable selects whether the Enable bit is set in the command. 

- Related Commands: VXhSELect, VXI:WSProtocol:RESPonse?, 
VXI:WSProtocol:QUERy? 

:WSProtoco[:MESSage:RECeive? 

VXI:WSProtocol:MESSage:RECeive? <count | terminator> receives a message 
from the selected logical address using both the word serial protocol and the 
byte transfer protocol. 

Parameters 


Parameter 

Name 

Parameter 

Type 

Range of Values 

Default 

Units 

<terminator> 

numeric 

count 1 LF| CRLF 1 END 

END 


Comments 

- The command will always terminate on the End bit being set. Additional 
termination options are on a specified number of bytes (count), or on a 
match to a particular terminator (That is, LF, CRLF, END). 

- The response is returned as a string. 

- Related Commands: VXhSELect, VXI:WSProtocol:MESSage:SEND 
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:WSProtoco[:MESSage:SEND 

VXI:WSP:MESS:SEND <message_string>[,(END | NEN)] sends the specified 
message_string to the selected logical address. The string is sent using the word 
serial protocol with the byte transfer protocol. 

Parameters 


Parameter 

Name 

Parameter 

Type 

Range of Values 

Default 

Units 

<message_string> 

text string 

Any valid test string. 

none 

<end_bit> 

discrete 

END 1NEN 

END 


Comments 

- The last byte of the string is sent with the end_bit set unless you specify 
NEN (NoENd). 

- Related Commands: VXLSELect, VXI:WSProtocol:MESSage:RECeive? 
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:WSProtoco[:QUERy:command? 

VXI:WSProtoco[:QUERy:command? is a series of commands which sends the 
specified Word Serial Command to the address set using the VXhSELect 
command and waits for a response. The returned value is the response to the 
command and is an integer. The following table lists the available commands 
and their parameters (if any). 


xommand 

parameterl 

parameter2 

Description 

:AHLine? 

<handjd> (1-7) 

<[ine_#> (0-7) 

Assign Handler Line. A line number of 0 

:AILine? 

<intjd> (1 - 7) 

<[ine_#> (0-7) 

means the handler is to be disconnected. 

:AMContro[? 

<rspns mask> (0 - 


Assign Interrupter Line. A line number of 0 

:AN0? 

15) 

<event #> (0 - 

means the handler is to be disconnected. 

:ANY? 

<cmd_word> 

127) 

Asynchronous Mode Control Abort Normal 

:BN0? 

(-32768 - 32767) 


Operation Specify any VXIbus command 

iBREQuest? 

<top_[eve[> 


Begin Normal Operation 

:CEVent? 

(01 non-zero) 

<modid> (0-127) 

Byte Request 

:CRESponse? 

<enab[e> 

<modid> (0 - 63) 

Control Event 

:EN0? 

(0|1 1 OFF ION) 


Control Response 

iRDEVice? 

<rspns_mask> (0 - 


End Normal Operation 

iRHANdlers? 

127) 


Release Device Read Handlers Read Handler 

iRHLine? 

<[ogicaLaddr> (0 - 


Line 

iRILine? 

255) 


Read Interrupter Line Read Interrupters 

iRINTerrupter? 

<handjd> (1 - 7) 


Read MODID 

iRMODid? 

<intjd> (1 - 7) 


Read Protocol Error 

iRPERror? 



Read Protocol Read Servant Area Read STB 

iRPRotocol? 

<enab[e> 


Set Lower MODID (lines 0 - 6) 

iRSARea? 

(0|1 1 OFF ION) 


Set Upper MODID (lines 7-12) 

:RSTB? 

<enab[e> 



:SLModid? 

(0|1 1 OFF ION) 



:SUModid? 





Comments 

- event_number, handjd, intjd, line_number, modid, and response_mask 
may be specified in decimal, hex (#H), octal (#Q), or binary (#B) formats. 

- topjevel selects whether the END bit is set in the command. 

- enable selects whether the Enable bit is set in the command. 

- Related Commands: VXhSELect, VXhWSProtocohCOMMand 

:WSProtoco[:RESPonse? 

VXhWSProtocohRESPonse? returns one word of data from the data low register 
on the selected logical address. This command obeys the byte transfer protocol. 
The data is returned as an integer. 
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This section describes the IEEE-488.2 common oommands that can be used to 
program instruments in the mainframe. Commands are listed alphabetically (the 
following table shows the common commands listed by functional group). 
Examples are shown when the command has parameters or returns a response; 
otherwise the command string is as shown in the headings in this section. For 
additional information on any common commands, refer to the IEEE Standard 
488.2-1987. 

IEEE 488.2 Common Command Functional Groupings 


Category 

Command 

Title 

General 

*IDN? 

Identification Query 


*RST 

Reset Command 


*TST? 

Self-test Query 

Instrument Status 

CO 

_1 

o 

* 

Clear Status Command 


*ESE <mask> 

Standard Event Status Enable Command 


*ESE? 

Standard Event Status Enable Query 


*ESR? 

Standard Event Status Register Query 


*PSC <flag> 

Power-on Status Clear Command 


*PSC? 

Power-on Status Clear Query Service 


*SRE <mask> 

Request Enable Command Service Request 


*SRE? 

Enable Query 


*STB? 

Status Byte Query 

Macros 

*DMC <name>,<cmds> 

Define Macro Command Enable Macros 


*EMC <state> 

Command Enable Macro Query 


*EMC? 

Get Macro Query 


*GMC? <name> 

Learn Macro Query 


* 

1 — 

o 

■■o 

Purge all Macros Command 


*PMC 

*RMC <name> 

Remove individual Macro Command 

Synchronization 

*0PC 

Qperation Complete Command 


*0PC? 

Qperation Complete Query 


*WAI 

Wait-to-Continue Command 
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*CLS 


Clear Status Command clears all status registers (Standard Event Status 
Register, Standard Operation Event Status Register, Questionable Data Event 
Register) and the error queue for an instrument. This clears the corresponding 
summary bits (bits 3, 5, and 7) and the instrument-specific bits (bits 0, 1, and 2) 
in the Status Byte Register. *CLS does not affect the enabling of bits in any of the 
status registers (Status Byte Register, Standard Event Status Register, Standard 
Operation Event Status Register, or Questionable Data Event Status Register). 
(The SCPI command STATus:PRESet does clear the Standard Operation Status 
Enable and Questionable Status Enable registers.) *CLS disables the Operation 
Complete function (*OPC command) and the Operation Complete Query function 
(*OPC? command). 


*DMC<name_string>,<command_b[ock> 

Define Macro Command assigns one, or a sequence of commands to a macro 
name. 

The command sequence may be composed of SCPI and/or Common commands. 

The name given to the macro may be the same as a SCPI command, but may not 
be the same as a common command. When a SCPI named macro is executed, 
the macro rather than the SCPI command is executed. To regain the function of 
the SCPI command, execute the *EMC 0 command. 

Example 

Create a Macro to Return the System Instrument’s Device List 

OUTPUT 70900;"*DMC ’LIST’,#OVXI:CONF:DLIS?" 

Note that the name LIST is in quotes. The second parameter type is arbitrary 
block program data. The characters that define a command message are prefixed 
by the characters #0 (pound zero). For a more information on this parameter 
type. 

*EMC <State> 

Enable Macros Command when enable is non-zero, macros are enabled. 

When enable is zero, macros are disabled. 


*EMC? 


Enable Macros Query returns either "1" (macros are enabled), or "0" (macros are 
disabled) for the selected instrument. 
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*ESE <mask> 

standard Event Status Enable Register Command enables one or more events in 
the Standard Event Status Register to be reported in bit 5 (the Standard Event 
Status Summary Bit) of the Status Byte Register. You enable an event by 
specifying its decimal weight for <mask>. To enable more than one event, specify 
the sum of the decimal weights. Refer to Chapter 4 in this manual for more 
information on the Standard Event Status Register. 

Example 

OUTPUT 70900;"*ESE 60" Enable Bits 2, 3, 4, and 5. 

Respective weights are 4 + 8 + 16 + 32 = 60. 

*ESE? 

Standard Event Status Enable Query returns the weighted sum of all enabled 
(unmasked) bits in the Standard Event Status Register. 

Example 

10 OUTPUT 70900;"*ESE?" 

20 ENTER 70900;A 
30 PRINT A 
40 END 

*ESR? 

Standard Event Status Register Query returns the weighted sum of all set bits in 
the Standard Event Status Register. After reading the register, *ESR? clears the 
register. The events recorded in the Standard Event Status Register are 
independent of whether or not those events are enabled with the *ESE 
command. 

Example 

10 OUTPUT 70900;"*ESR?" Send Standard Event Status 

Register query. 

20 ENTER 70900;A Place response in variable. 

30 PRINT A Print response. 

40 END 


Send status enable query. 
Place response in variable. 
Print response. 
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*GMC? <name_string> 

Get Macro Query returns arbitrary block response data which contains the 
command or command sequence defined by name_string. The command 
sequence will be prefixed with characters which indicate the number of 
characters that follow the prefix. 

Example 

10 OUTPUT 70900;"*GMC? "LIST"" 

20 ENTER 70900;Cmds$ 

30 PRINT Cmds$ 

40 END 

In this case, the prefix consists of "#214". The 2 says to expect two 
character-counting digits. The 14 says that 14 characters of data follow. Had the 
returned macro been shorter, such as #15*EMC?, we would read this as 1 
counting digit indicating 5 data characters. 


Ask for definition of macro from 
*DMC example. 

Enter into Cmds$ the definition 
of the macro "LIST". 

Cmds$=#214VXI:CONE:DLIS ? 


*IDN? 


Identity returns the device identity. The response consists of the following four 
fields (fields are separated by commas): 

— Manufacturer 

— Model Number 

— Serial Number (returns 0 if not available) 

— Firmware Revision (returns 0 if not available) 

The *IDN? command returns the following command string for the E1406A 
System instrument (Flash ROMS Run/Load switch is in the "Run" position): 

HEWLETT-PACKARD,E1406A,0,A,01.00 

This command will return the following string for the Keysight E1406A Loader 
instrument (Flash ROMS Run/Load switch is in the "Load" position): 

HEWLETT-PACKARD,LOADER,0,A,01.00 


NOTE 


The revision will vary with the revision of the downloaded 
operating system installed in the system. This is the only 
indication of which version of operating system is in the box. The 
major number (01 in the examples) indicates whether there have 
been functional changes made in this downloaded operating 
system. The minor number (00 in the examples) indicates whether 
only bug fixes and minor changes were made. 
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Example 

Get and Print the ID Fields from the System 


10 DIM A$[50] 

20 OUTPUT 70900;"*IDN? 
30 ENTER 70900;A$ 

40 PRINT A$ 

50 END 


Dimension array for ID fields. 
Query identity. 

Place ID fields in array. 

Print ID fields. 


*LMC? 


*LRN? 


Learn Macros Query returns a quoted string name for each currently defined 
macro. If more than one macro is defined, the quoted strings are separated by 
commas (,). If no macro is defined, then a quoted null string ("") is returned. 


Learn Query Command causes the instrument to respond with a string of SCPI 
commands which define the instrument’s current state. Your application program 
can enter the *LRN? response data into a string variable, later to be sent back to 
the instrument to restore that configuration. 

Example response from an Keysight E1326B multimeter in the power-on 
state: 

*RST;:CAL:ZERO:AUTO 1; :CAL:LFR +60; VAL 

+0.00000000E+000; :DISP:MON:STAT 0; CHAN (@0); :FORM ASC,+7; :FUNC 

"VOLT"; ;MEM;VME:ADDR +2097152; SIZE 

+0; STAT 0; ;RES:APER +1.666667E-002; OCOM 0; RANG 

+1.638400E+004; RANG:AUTO l;:VOLT:APER 

+1.666667E-002; RANG +8.000000E+000; RANG:AUTO 1; 

:TRIG:COUN +1; DEL +0.00000000E+000; DELiAUTO 1; 

:TRIG:SOUR IMM; :SAMP:COUN+l; SOUR IMM;TIM 
+5.000000E-002 S 


The System instrument no longer implements the *LRN? 
command. Attempting to have the System instrument execute 
this command will generate Error -113, "Undefined header". 



Qperation Complete causes an instrument to set bit 0 (Qperation Complete 
Message) in the Standard Event Status Register when all pending operations 
have been completed. By enabling this bit to be reflected in the Status Byte 
Register (*ESE 1 command), you can ensure synchronization between the 
instrument and an external computer or between multiple instruments. 


*LMC? 


*LRN? 


268 


Keysight E1406A User Manual and SCPI Programing Guide 





Common Command Reference 


Keysight El 406A Command Reference 


*OPC? 

Operation Complete Query eauses an instrument to place an ASCII 1 into the 
instrument’s output queue when all pending instrument operations are finished. 
By requiring the computer to read this response before continuing program 
execution, you can ensure synchronization between one or more instruments and 
the computer. 

*PMC 

Purge Macros Command purges all currently defined macros in the selected 
instrument. 

*PSC <f[ag> 

Power-on Status Clear Command controls the automatic power-on clearing of 
the Service Request Enable Register and Standard Event Status Enable Register. 
Executing *PSC 1 disables any previously enabled bits at power-on, preventing 
the System instrument from requesting service when power is cycled. Executing 
*PSC 0 causes any previously enabled bits to remain enabled at power-on which 
allows the System instrument to request service (if it has been enabled - *SRE) 
when power is cycled. The value of flag is stored in non-volatile memory. 

Example 

This example configures the System instrument to request service from the 
external computer whenever power is cycled. 

Status Byte Register and Standard Event Status Register bits remain 
enabled (unmasked) after cycling power. 

10 OUTPUT 70900;"*PSC 0" 

Enable bit 5 (Standard Event Status Register Summary bit) in the 
Status Byte Register. 

20 OUTPUT 70900;"*SRE 32" 

Enable bit 7 (Power-on bit) in the Standard Event Status Register to 
be reflected as bit 5 in the Status Byte Register. 

30 OUTPUT 70900;"*ESE 128" 


*PSC? 


Power-on Status Clear Query returns a response indicating whether an 
instrument’s Status Byte Register and Standard Event Status Register bits 
remain enabled or become disabled at power-on. A "1" means the bits are 
disabled at power-on; a "0" means the bits remain enabled at power-on. 
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*RMC <name_string> 

Remove Individual Macro Command purges an individual macro identified by the 
name_string parameter. 

Example 

OUTPUT 70900;"*RMC ’LIST’" Remove macro command from *DMC 
example. 


*RST 

Reset Resets an instrument as follows: 

— Sets the instrument to a known state (usually the power-on state). 
— Aborts all pending operations. 

— Disables the *OPC and *OPC? modes. 

*RST does not affect: 

— The state of the GPIB interface. 

— The GPIB address. 

— The output queue. 

— The Service Request Enable Register. 

— The Standard Event Status Enable Register. 

— The power-on flag. 

— Calibration data. 

— Protected user data. 


*SRE <mask> 

Service Request Enable When a service request event occurs, it sets a 
corresponding bit in the Status Byte Register (this happens whether or not the 
event has been enabled (unmasked) by *SRE). The *SRE command allows you to 
identify which of these events will assert a service request (SRQ). When an event 
is enabled by *SRE and that event occurs, it sets a bit in the Status Byte Register 
and issues an SRQ to the computer (sets the GPIB SRQ line true). You enable an 
event by specifying its decimal weight for <mask>. To enable more than one 
event, specify the sum of the decimal weights. Refer to Chapter 4 in this manual 
for more information on the Status Byte Register. 
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Example 

OUTPUT 70900;"*SRE 160" Enables bits 5 and 7. Respective weights 

are 32 + 128 = 160. 


*SRE? 

Status Register Enable Query returns the weighted sum of all enabled 
(unmasked) events (those enabled to assert SRQ) in the Status Byte Register. 

Example 

10 OUTPUT 70900;"*SRE?" Send Status Register Enable query. 

20 ENTER 70900;A Place response in variable. 

30 PRINT A Print response. 

40 END 

*STB? 

Status Byte Register Query returns the weighted sum of all set bits in the Status 
Byte Register. Refer to Qhapter4 in this manual for more information on the 
Status Byte Register. 

Comments 

You can read the Status Byte Register using either the *STB? command or an 
GPIB serial poll (IEEE 488.1 message). Both methods return the weighted sum of 
all set bits in the register. The difference between the two methods is that *STB? 
does not clear bit 6 (Service Request); serial poll does clear bit 6. No other Status 
Byte Register bits are cleared by either method with the exception of the 
Message Available bit (bit 4) which may be cleared as a result of reading the 
response to *STB?. 

Example 

10 OUTPUT 70900;"*STB?" Send Status Byte Register query. 

20 ENTER 70900;A Place response in variable. 

30 PRINT A Print response. 

40 END 

*TST? 


Self-Test causes an instrument to execute an internal self-test and returns a 
response showing the results of the self-test. A 0 (zero) response indicates that 
self-test passed. A value other than zero indicates a self-test failure or error. 
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Example 

10 OUTPUT 70900;"*TST?" Execute self-test, return response. 

20 ENTER 70900;A Place self-test response in variable. 

30 PRINT A Print response. 

40 END 


*WAI 


Wait-to-continue prevents an instrument from executing another command until 
the operation caused by the previous command is finished (sequential 
operation). Since all instruments normally perform sequential operations, 
executing the *WAI command causes no change to the instrument’s operation. 
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GPIB Message Reference 

This section describes IEEE-488.1 defined messages and their affect on 
instruments installed in the mainframe. The examples shown are specifically for 
HP 9000 Series 200/300 computers using BASIC language. Although any 
IEEE-488 controller can send these messages, the syntax may be different from 
that shown here. 


Device Clear (DCL) or Selected Device Clear (SDC) 

DCL clears all instruments in the command module servant area. SDC clears a 
specific instrument. The purpose of DCL or SDC is to prepare one or more 
instruments to receive and execute commands (usually *RST). 

DCL or SDC do the following to each instrument: 

— Clear the input buffer and output queue. 

— Reset the command parser. 

— Disable any operation that would prevent *RST from being executed. 

— Disable the Operation Complete and Operation Complete Query modes. 
— DCL or SDC does not affect: 

— Any settings or stored data in the instrument (except the Operation 
Complete and Operation Complete Query modes). 

— Front panel operation. 

— Any instrument operation in progress (except as stated above). 

— The status byte (except for clearing the Message Available bit as a 
result of clearing the output queue). 

Example 

CLEAR 7 Clear all instruments. 

CLEAR 70900 Clear the System instrument. 

Go To Local (GTL) 

Places an instrument in local state. 

Comments 

- Refer to the Local Lockout message later in this chapter for information on 
how GTL affects front panel lockout. 
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Example 

Set GPIB remote enable line false (all instruments go to local). (You must now 
execute REMOTE 7 to return to remote mode). 

LOCAL 7 

Issue GPIB GTLto System instrument. (The instrument will return to remote 
mode when it is listen addressed.) 

LOCAL 70900 

Group Execute Trigger (GET) 

Executing a group execute trigger will trigger an instrument assuming the 
following conditions are true: 

— The instrument’s trigger source is set to Bus (TRIG:SOUR BUS 
command), 

— The instrument is in the Wait-for-Trigger state, and; 

— The instrument is addressed to listen (can be done by sending any 
command, the REMOTE 709ss (ss = secondary address) command, or 
with the LISTEN command). 

Comments 

- For instruments in the servant area of an Keysight El 406A Command 
Module, only one instrument at a time can be programmed to respond to 
GET. This is because only one instrument can be addressed to listen at any 
one time. GET has no affect on the System instrument. 

Interface Giear (IEG) 

Unaddresses all instruments in the servant area of the specified command 
module and breaks any bus handshaking in progress. 

Example 

ABORT 7 

Local Lockout (LLO) 

When an instrument is in remote mode. Local Lockout prevents an instrument 
from being operated from the mainframe’s front panel. 

Comments 

- Certain front panel operations such as menu control and display scrolling 
are still active in Local Lockout mode. 
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- If the instrument is in the iocai state when you send LOCAL LOCKOUT, it 
remains in iocai. If the instrument is in the remote state when you send 
LOCAL LOCKOUT, front panel control is disabled immediately for that 
instrument. 

- After executing LOCAL LOCKOUT, you can enable the keyboard by sending 
the LOCAL 7 command or by cycling power. The LOCAL 709ss (ss = 
secondary address) command enables the front panel for that instrument 
but a subsequent remote command disables it. Sending the LOCAL 7 
command removes lockout for all instruments and places them in the local 
state. 

Example 

10 REMOTE 70900 Set the System instrument remote state. 

20 LOCAL LOCKOUT 7 Disable front panel control for the System 

instrument and all other instruments that were 
in the remote state. 

30 END 


Remote 


Sets the GPIB remote enable line (REN) true which places an instrument in the 
remote state. 

Comments 

- The REMOTE 709ss (ss = secondary address) command places the 
instrument in the remote state. The REMOTE 7 command, does not, by 
itself, place the instrument in the remote state. After sending the REMOTE 
7 command, the instrument will only go into the remote state when it 
receives its listen address. 

- In most cases, you will only need the REMOTE command after using the 
LOCAL command. REMOTE is independent of any other GPIB activity and 
toggles a single bus line called REN. Most controllers set the REN line true 
when power is applied or when reset. 

Example 

REMOTE 7 Sets GPIB REN line true. 

REMOTE 70900 Sets REN line true and addresses System 

instrument. 
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Serial Poll (SPOIL) 

The SPOIL command, like the *STB? Common Command, returns the weighted 
sum of all set bits in an instrument’s Status Byte Register (status byte). Refer to 
Chapter 4 in this manual for more information on the Status Byte Register. 

Comments 

- The SPOIL command differs from the *STB? command in that SPOLL 
clears bit 6 (SRC)- Executing *STB? does not clear bit 6. 

Example 

10 P=SPOLL (70900) Send Serial Poll and place response into P. 

20 DISP P Display response. 

30 END 
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Common Commands Quick Reference 

The following table summarizes IEEE 488.2 common (*) commands for the 
Keysight E1406A Command Module. All common commands are available in 
RUN mode and LOAD mode. 


IEEE 488.2 Common Commands Quick Reference 


Category Command Title 


All IEEE 488.2 Common Commands are available in RUN mode and LOAD mode. 


General 

*IDN? 

Identification Query 


*RST 

Reset Command 


*TST? 

Self Test Query 

Instrument Status 

*CLS 

Clear Status Command 


*ESE <mask> 

Standard Event Status Enable Register Command 


*ESE? 

Standard Event Status Enable Query 


*ESR? 

Standard Event Status Register Query 


*PSC <flag> 

Power-on Status Clear Command 


*PSC? 

Power-on Status Clear Query 


*SRE <mask> 

Service Request Enable Command 


*SRE? 

Service Request Enable Query 


*STB? 

Status Byte Register Query 

Macros 

*DMC <name>,<cmds> 

Define Macro Command 


*EMC <state> 

Enable Macro Command 


*EMC? 

Enable Macro Query 


*GMC? <name> 

Get Macro Query 


*LMC? 

Learn Macro Query 


*PMC 

Purge all Macros Command 


*RMC <name> 

Remove individual Macro Command 

Synchronization 

*OPC 

Qperation Complete Command 


*OPC? 

Qperation Complete Query 


*WAI 

Wait-to-Continue Command 
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and General Information 


Device Type 

This module returns 01416 as the device type in response to a VXI:CONF:DLIS? 
query if the Keysight El 406A is set up as a slot zero device and 11416 if the 
Keysight E1406A is set up as a non-slot zero device. 

Real Time Clock 

Accuracy: 0.005% of elapsed time since last set. 

Temperature coefficient: 0.001 % to 0.012% of time since last set (per °C change in 
temperature). 

Resolution: 1.0 sec 

Non-volatile lifetime: 10 months minimum for a module with 512 Kbyte memory 
(following a 15 hour battery charge). 5 months for a module with 1 Mbyte of 
memory. 2.5 months for a module with 2 Mbyte of memory. 


CLKIO 

Input: TTL or low level AC Minimum input level: 40 mVp-p Maximum input level: 

42.5 Vp-p Output: TTL 

Jitter: 0.03% (-55 dB) 

Initial Accuracy: 50 ppm 

Maximum Stability: ±20 ppm/year (0°-55 °C) 

Typical Stability:±3 ppm/year at 25 °C) 

Trigger Input 

Levels: TTL 

Input load: 5 kQ, 50 pF 

Maximum Rate: 12.5 MFIz (TTL), 40 MFIz (ECL) Minimum pulse width: 30 ns (TTL), 

12.5 ns (ECL) Maximum trigger delay: 30 ns 



KEYSIGHT 

TECHNOLOGIES 
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Memory 


256 Kbyte user accessible volatile RAM on a module with 512 Kbyte of 
non-volatile memory. Memory is expandable to 2 Mbyte. NiCad battery backed 
(10 month minimum lifetime for modules with 512 Kbyte of non-volatile RAM, 5 
months for modules with 1 Mbyte of non-volatile RAM, and 2.5 months for 
modules with 2 Mbyte of non-volatile RAM following a 15 hour battery charge). 


Power Requirements 


1 DC Volts 

DC Current 

DC Current I 

+5 

3.2A 

0.32A 

+12V 

0.01 A 

0.01 A 

-12V 

0.01 A 

0.01 A 

-5.2V 

0.4A 

0.04A 

-2V 

0.01 A 

0.01 A 

+24V 

0.03A 

0.003A 


Cooling Requirements 

For 10 °C rise 1.5 liters/second 0.4mm H 2 O 


SCPI Conformance Information 


The Keysight El 406A conforms to SCPI-1994.0. The following tables list all the 
SCPI confirmed and non-SCPI commands that the Keysight El 406A can execute. 
Individual commands may not execute without having the proper plug-in module 
installed in the mainframe. Each plug-in module manual describes the 
commands that apply to that module. 

Switohbox Configuration 

The following plug-in modules can be configured as switchbox modules. Refer to 
the individual plug-in User’s Manual for configuration information. 


Keysight E1345A 

Keysight E1353A 

Keysight E1366A 

Kevsight E1346A 

Kevsight E1357A 

Kevsight E1367A 

Kevsight E1347A 

Kevsight E1358A 

Kevsight E1368A 

Kevsight E1351A 

Kevsight E1361A 

Kevsight E1369A 

Keysight E1352A 

Kevsight E1364A 

Kevsight E1370A 
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Table A-1. Switchbox SCPI-1994.0 Confirmed Commands 


ABORt 

ARM 

:COUNt 

INITiate 
:CONTinuous 
[: IM Mediate] 

OUTPut 

:ECLTrg<n> 

[:STATe] 

:TTLTrg<n> 

[:STATe] 

[ROUTe:] 

CLOSe 

CLOSe? 

OPEN 

OPEN? 

SCAN 


STATUS 

:OPERation 

:CONDition? 

:ENABle 

:ENABle? 

[:EVENt]? 

:PRESet 

iQUEStionable 

:CONDition? 

:ENABle 

:ENABle? 

[:EVENt]? 

SYSTem 

:CPON 

:CTYPe? 

:ERRor? 

:VERSion? 

TRIGger 
[: IM Mediate] 
:SOURce 
:SLOPe 


Table A-2. Switchbox Non-SCPI Commands 


Display 

[ROUTe:] 

:MONitor 

SCAN 

:CARD 

[:LIST] 

[:STATe] 

:MODE 


:PORT 

SYSTem 


:CDEScription? 

:SETTling 


[:TIME] 


:TIME? 
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Multimeter Commands 

The following tables apply to the Keysight El 326A/B multimeters. 
Table A-3. Multimeter SCPI-1994.0 Confirmed Commands 


ABORt 

[SENSe:] 


FUNCtion 

CALibration 

FUNCtion? 

:VALue 

RESistance 

:ZER0 


APERture 

AUTO 


APERture? 

AUTO? 


:NPLCycles 

:NPLCycles? 

CONFigure 


:RANGe 

:FRESistance 


AUTO 

:RESistance 


AUTO? 

:TEMPerature 


:RANGe? 

:VOLTage 


:RESolution 

AC 


:RESolution? 

[:DC] 

VOLTage 

AC 

CONFigure? 


:RANGe 
:RANGe? [ 

FETCh? 


:DC] 

:RANGe 

FORMat 


AUTO 

[:DATA] 


AUTO? 

:RANGe? 

INITiate 


iRESolution 

[:IMMediate] 


iRESolution? 

:NPLCycles 

MEASure 

:FRESistance? 


:NPLCycles? 

:RESistance? 

STATUS 

:TEMPerature? 

:0PERation 

:VOLTage 


CONDition? 

AC? 


:ENABle 

[:DC]? 


:ENABle? 

[:EVENt]? 

READ? 

:PREset 

iQUEStionable 

:CONDition? 

:ENABle 

:ENABle? 

[:EVENt]? 


SY' 

5Tem 

CTYPe? 

ERRor? 

VERsion? 


TRI 

Gger 

COUNt 

COUNt? 

DELay? 

AUTO 

AUTO? 

DELay? 

flMMediate] 

SOURce 

SOURce? 
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Table A-4. Multimeter Non-SCPI Commands 


CALibration 

IFRequency 

IFRequency? 

:STRain 

CONFigure 

:STRain 

:FBENding 

iFBPoisson 

iFPOisson 

iHBENding 

iFIPOisson 

iOCOMpression 

iQTENsion 

:0UARter 

:UNSTrained 

Display 

:MONitor 

iCHANnel 

iCHANnel? 

[:STATe] 

[:STATe]? 

MEASure 

:STRain 

iFBENding? 

iFBPoisson? 

iFPOisson? 

iHBENding? 

iFIPOisson? 

:OCOMpression? 

:0TENsion? 

:QUARter? 

:UNSTrained? 


MEMory 

:VME 

:ADDRess 

:ADDRess? 

:SIZE 

:SIZE? 

[:STATe] 

[:STATe]? 

[ROUTe:] 

FUNCtion 

SAMPle 

:COUNt 

:COUNt? 

:SOURce 

:SOURce? 

TIMer 

TIMer? 

[SENSe:] 

RESistance 

:OCOMpensated 

:OCOmpensated? 

STRain 

:GFACtor 

:POISson 

:UNSTrained 

SYSTem 

:CDEScription 
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Counter Commands 

The following tables apply to the Keysight El 332A 4-Channel Counter/Totalizer 
and the Keysight E1333A 3-Channel Universal Counter. 

Table A-5. Keysight E1332A SCPI-1994.0 Confirmed Commands 


ABORt 

READ? 

CONFigure 

[SENSe:] 

iFREQuency 

FREQuency 

iPERiod 

:APERture 

iPWIDth 

:APERture? 

iNWIDth 

FUNCtion 

iFREQuency 

CONFigure? 


PERiod 

FETCh? 

STATUS 


iOPERation 

FORMat 


CONDition? 

[:DATA] 


ENABIe 

ENABIe? 

INITiate 

[:EVENt]? 

[:IMMediate] 

:PREset 


iQUEStionable 

INPut 


CONDition? 

iFILTer 


ENABIe 

[:LPASs] 


ENABIe? 

[:STATe] 

[:EVENt]? 

[:STATe]? 

iFREQuency 

SYSTEM 

iFREQuency? 

:ERRor? 


iVERSion? 

MEASure 

iFREQuency? 

TRIGger 

iPERiod? 

[dMMediate] 

iPWIDth? 

:S0URCe 

iNWIDth 

:S0URCe? 
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Table A-6. Ke ysight E1332A Non-SCPI Commands 


CONF[<channe[>] 

TOTalize 

TINTerval 

:UDCount 

Display 

iMONitor 

iCHANnei 

iCHANnel? 

[:STATe] 

[:STATe]? 

INPut 

ilSOLate 

dSOLate? 


[SENSe[<channe[>:]] 

EVENt 

:LEVe[ 

:LEVe[? 

:SLOPe 

:SLOPe? 

PERiod 

:NPERiods 

:NPERiods? 

TOTalize 

:GATE 

iPOLarity 

:POLarity? 

[:STATe] 

[:STATe]? 


MEASure[<channel>] 

TINTerval? 
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Table A-7. Keysight E1333A SCPI-1994.0 Confirmed Commands 


ABORt 

READ? 

FETCh? 

[SENSe:] 


FUNCtion 

CONFigure 


FREQuency 

iFREQuency 


PERiod 

iNWIDth 

FREQuency 

iPERiod 

:APERture 

iPWIDth 

:APERture? 

CONFigure? 

STATUS 


iOPERation 

FORMat 


CONDition? 

[:DATA] 


ENABIe 

ENABIe? 

INITiate 

[:EVENt]? 

[:IMMediate] 

:PREset 


iQUEStionable 

INPut 


CONDition? 

:ATTenuation 


ENABIe 

:ATTenuation? 


ENABIe? 

iCOUPling 


[EVENt]? 

iCOUPling? 

:FILTer 

SYSTem 

[:LPASs] 

:ERRor? 

[:STATe] 

:VERSion? 

[:STATe]? 

ilMPedance 

TRIGger 

ilMPedance? 

[dMMediate] 


:SOURCe 

MEASure 

:SOURCe? 

iFREQuency? 

iNWIDth? 

iPERiod? 

iPWIDth? 
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Table A-8. Keysight E1333A Non-SCPI Commands 


CONF[<channe[>] 

:RATio 

TOTalize 

TINTerval 

Display 

iMONitor 

iCHANnei 

iCHANnel? 

[:STATe] 

[:STATe]? 

MEASure[<channe[>] 

:RATio? 

TINTerval? 


[SENSe[<channel>:]] 

EVENt 

:LEVel 

:LEVel? 

:SLOPe 

:SLOPe? 

PERiod 

:NPERiods 

:NPERiods? 

RATIO 

:NPERiods 

iNPERiods? 

TINTerval 

:NPERiods 

:NPERiods? 


D/A Converter Commands 

The following tables apply to the Keysight El 323A 4-Channel D/A Converter. 
Table A-9. Keysight El 328A SCPI-1994.0 Confirmed Commands 


CALibration 

STATUS 

[:STATe] 

:OUEStionable 

[:STATe]? 

:C0NDition? 


lENABle 

SYSTem 

:ENABle? 

:ERRor? 

[:EVENt]? 

:VERSion? 

:0PERation 


:C0NDition? 


lENABle 


lENABle? 


[:EVENt]? 
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Table A-10. Keysight E1328A Non-SCPI Commands 


CALibration 

:CURRent 

:VOLTage 

Display 
iMONitor 
:CHANne[ 
iCHANnel? [:STATe] 
:STRing? 


SOURce 

:CURRent <channe[> 
:CURRent <channe[>? 
:FUNCtion <channe[>? 
:VOLTage <channe[> 
:VOLTage <channe[>? 


Digital I/O Commands 

The following tables apply to the Keysight El 330A/B Quad 8-bit Digital I/O 
Module. 

Table A-11. Keysight El 330A/B SCPI-1994.0 Confirmed Commands 


STATUS 

SYSTem 

iOPERation 

:ERRor? 

:C0NDition? 

:VERSion? 

lENABIe 


lENABIe? 


[:EVENt]? 


iPREset 


iQUEStionable 


iCONDition? 


lENABIe 


lENABIe? 


[:EVENt]? 
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Table A-12. Keysight E1330A/B Non-SCPI Commands 


Display 

[SOU Roe:] 

:MONitor 

DIGital 

:PORT 

:CONTro[ <port> 

:PORT? 

:POLarity 

[:STATe] 

:POLarity? 

:STRing? 

[:VALue] 

:DATA <port> 

MEASure 

:BIT <number> 

iDIGital 

TRACe 

:DATA <port>? 

:HANDshake 

:BIT <number>? 

:DELay 

:BLOCk? 

[:MODE] 

:FLAG <port>? 

[:MODE]? 

iPOLarity 

MEMory 

:POLarity? 

iDELete 

[:VALue] 

MACRO 

:FLAG <port> 

:VME 

:POLarity 

:ADDRess 

:POLarity? 

:ADDRess? 

:HANDshake <port> 

:SIZE 

:DELay 

:SIZE? 

[:MODE] 

[:STATe] 

[:MODE]? 

[:STATe]? 

TRACe 

iCATalog 

[:DATA] 

[:DATA]? 

iDEFine 

iDELete 
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Table A-13. System Instrume 


OUTPut 

:ECLTrg<n> 

ilMMediate 

lEVel 

[: IM Mediate] 
[dMMediate]? 
:SOURce 
:SOURce? 
[:STATe] 

[:STATe]? 

:TTLTrg<n> 

ilMMediate 

lEVei 

[:IM Mediate] 
[dMMediate]? 
:SOURce 
:SOURce? 
[:STATe] 

[:STATe]? 

PROGram 

[:SELected] 

iDEFine 

iDEFine? 

iDELete 

:ALL 

[:SELected] 

STATUS 

:OPERation 

iCONDition? 

lENABle 

lENABle? 

[:EVENt]? 

iNTRansition 

iPTRansition 

:PREset 

iQUEStionable 

:CONDition? 

lENABle 

lENABle? 

[:EVENt]? 

iNTRansition 

iPTRansition 


SYSTem 

:COMMunicate 

:GPIB 

:ADDRess? 

:SERia[ 

:CONTro[ 

:DTR 

:DTR? 

:RTS 

:RTS? 

[:RECeive] 

:BAUD 

:BAUD? 

:BITS 

:BITS? 

:PACE 

:PARity 

:SBITs 

:SBITs? 

TRANsmit 

:AUTO 

:AUTO? 

:PACE 

:DATE 

:DATE? 

:ERRor? 

TIME? 

:VERSion? 

VXI 

:CONFigure 

:DNUMber? 

:HIERarchy? 

:ALL? 

dNFormation? 

:ALL? 

:LADDress? 

:NUMBer? 

:REGister 

:READ? 

:WRITe 

:RESet? 

:SELect 
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VXI 

:WSProtoco[ 

:COMMand 

:AHLine 

:AILine 

:AMContro[ 

:ANO 

[:ANY] 

iBAVailable 

:BNO 

:BRQ 

:CEVent 

:CLR 

:CLOCk 

:CRESponse 

:ENO 

:GDEVice 

dCOMmander 

:RDEVice 

iRHANdlers 

:RHLine 

:RILine 

:RINTerrupter 

:RMODid 

:RPERror 

:RPRotoco[ 

:RSTB 

:RSARea 

:SLModid 

:SLOCk 

:SUModid 

TRIGger 

:MESSage 

:RECeive? 

:SEND 


VXI 

:WSProtoco[ 

:QUERy 
:AHLine? 
:AILine? 
:AMContro[? 
:ANO? [:ANY?] 
:BNO? 
:BR0uest? 
:CEVent? 
:CRESponse? 
:ENO? 
:RDEVice? 
:RHANd[ers? 
:RHLine? 
:RILine? 
:RINTerrupter? 
:RMODid? 
:RPERror? 
:RPRotoco[? 
:RSARea? 
:RSTB? 
:SLModid? 
:SUModid? 
:RESPonse? 
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Table A-14. System 

DIAGnostic 

:BOOT 

:COLD 

[:WARM] 

iCOMMunicate 

:SERia[[0] 

[:OWNer] 

[:OWNer]? 

:SERia[[n] 

:STORe 

iDOWNload 

CHECked 

[:MADDress] 

:SADDress 

[:MADDress] 

:SADDress 

:DRAM 

lAVAilable? 

:CREate 

:CREate? 

iDRIVer 

ilNSTall 

ilST 

[:ALL]? 

:FROM? 

:RAM? 

:ROM? 

iOAD 

:CHECked 

:FROM 

lAVAilable 

:CREate 

:CREate? 

:SIZE? 


Instrument Non-SCPI Commands 

DIAGnostic 

dNTerrupt 

:ACTivate 

:PRIority[n] 

:PRIority[n]? 

:RESPonse? 

:SETup[n] 

:SETup[n]? 

:NRAM 

:ADDRess? 

:CREate 

:CREate? 

:PEEK? 

:POKE 

:RDISK 

:ADDRess? 

:CREate 

:CREate? 

:UPLoad? 

[:MADDress] 

:SAD Dress 

OUTPut 

:EXTerna[ 

dMMediate 

:LEVe[ 

[dMMediate] 

[dMMediate]? 

:SOURce 

:SOURce? 

[:STATe] 

[:STATe]? 


PROGram 

[:SELected] 

:CHECked 

:CHECked? 

:DEFine? 


:CONFigure 

iCTABle 

iDCTabie 

:DLADdress? 

:DLIST? 

:ETAB[e 

dTABle 

:READ? 

:RECeive[:MESSage] 

:RESet 

:SEND 

:COMMand 

[:MESSage] 

:WRITe 
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Table A-15. IEEE Mandated Common (*) Commands 


CO 

_1 

o 

* 

1— 
CO 

q: 

* 

LU 

CO 

LU 

* 

*SRE 

*ESE? 

*SRE? 

*ESR? 

*STB? 

*IDN? 

*TST? 

*0PC 

*WAI 

*0PC? 
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B Keysight El406A Error Messages 


Using This Appendix 


This appendix shows how to read an instrument’s error queue, discusses the 
types of command language-related error messages, and provides a table of all 
of the System Instrument’s error messages and their probable causes. 


Reading an Instrument’s Error Queue page 293 
Error Types page 294 

Start-up Error Messages and Warnings page 301 


Reading an Instrument’s Error Queue 


Executing the SYST:ERR? command reads the oldest error message from the 
instruments error queue and erases that error from the error queue. The response 
format is: <error number>,"<error description string>". 

Example error message: -113, "Undefined header" 

Positive error numbers are specific to an instrument. Negative error numbers are 
command language-related and discussed in “Error Types”. Command 
language-related errors also set a corresponding bit in the Standard Event 
Status Register (refer to Chapter 4 for more information). 


Example: Reading the Error Queue 

This program reads all errors (one error at a time, oldest to newest) from the 
System instrument’s (command module) error queue. After reading each error, 
that error is automatically erased from the queue. When the error queue is 
empty, this program returns: +0, "No error". 


10 OPTION BASE 1 
20 DIM Message$[256] 

30 REPEAT 

40 OUTPUT 70900;"SYST:ERR?" 
50 ENTER 70900;Code,Messages 
60 PRINT CodejMessageS 
70 UNTIL Code=0 


Create array for error message. 

Repeat next 3 tines untit error number = 0. 
Read error number and message. 

Enter error number and message. 

Print error number and message. 



80 END 


KEYSIGHT 


TECHNOLOGIES 
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Error Types 


Error codes read from the error queue are preceded by the number 21. For 
example, error code 11 displayed on a monitor appears as 2111 if read from the 
error queue instead. 

Error Types 

Negative error numbers are language-related and categorized as shown in Table 
B-1. Positive error numbers are instrument specific and for the System 
instrument are summarized in Table B-2. For other instruments, refer to their 
own user’s manual for a description of error messages. 


Table B-1 Negative Error Numbers 


1 Error Number 

Error Type I 

-199 to-100 

Command Errors Execution 

-299 to -200 

Errors Device-Specific Errors 

-399 to -300 

Query Errors 

-499 to -400 



Command Errors 

A command error means the instrument cannot understand or execute the 
command. When a command error occurs, it sets the Command Error bit (bit 5) 
in the Standard Event Status Register. Command errors can be caused by: 

- A syntax error was detected in a received command or message. Possible 
errors include a data element which violates the instrument’s listening 
formats or is of the wrong type (binary, numeric, etc.) for the instrument. 

- An unrecognizable command header was received. Unrecognizable 
headers include incorrect SCPI headers and incorrect or unimplemented 
common commands. 

- A Group Execute Trigger (GET) was entered into the input buffer inside of a 
common command. 

Execution Errors 

An execution error indicates the instrument is incapable of doing the action or 
operation requested by a command. When an execution error occurs, it sets the 
Execution Error bit (bit 4) in the Standard Event Status Register. Execution errors 
can be caused by the following: 

- A parameter within a command is outside the limits or inconsistent with 
the capabilities of an instrument. 

- A valid command could not be executed because of an instrument failure 
or other condition. 
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Device-Specific Errors 

A device-specific error indicates an instrument operation did not complete, 
possibly due to an abnormal hardware or firmware condition (self-test failure, 
loss of calibration or configuration memory, and so forth). When a 
device-specific error occurs, it sets the Device-Specific Error bit (bit 3) in the 
Standard Event Status Register. 

(^uery Errors 

A query error indicates a problem has occurred in the instrument’s output queue. 
When a query error occurs, it sets the Query Error bit (bit 2) in the Standard 
Event Status Register. Query errors can be caused by the following: 

- An attempt was made to read the instrument’s output queue when no 
output was present or pending. 

- Data in the instrument’s output queue has been lost for some reason. 
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Error Types 


Table B-2 Error Messages and Causes 


1 Error Messages and Causes 


Code 

Message 

Cause 

-101 

Invalid character 

Unrecognized character in specified parameter. 

-102 

Syntax error 

Command is missing a space or comma between parameters. 

-103 

Invalid separator 

Command parameter is separated by some character other 
than a comma. 

-104 

Data type error 

The wrong data type (for example, number, character, string expression) was used 
when specifying a parameter. 

-108 

Parameter not allowed 

Parameter specified in a command which does not require one. 

-109 

Missing parameter 

No parameter specified in the command in which a parameter 
is required. 

-113 

Undefined header 

Command header was incorrectly specified. 

-123 

Numeric overflow 

A parameter specifies a value greater than the command allows. 

-128 

Numeric data not allowed 

A number was specified for a parameter when a letter is required. 

-131 

Invalid suffix 

Parameter suffix incorrectly specified 
(e.g. .5SECOND rather than .58 or .5SEC). 

-138 

Suffix not allowed 

Parameter suffix is specified when one is not allowed. 

-141 

Invalid character data 

The discrete parameter specified is not allowed 
(e.g. TRIG:SOUR INT - INT is not a choice). 

-160 

Block data error 

The block sent either contained more data then the Flash ROMS could hold or 
the block count field disagreed with the number of bytes actually sent. 

-178 

Expression data not allowed 

A parameter other than the channel list is enclosed in parentheses. 

-211 

Trigger ignored 

Trigger occurred from a source other than the specified source. 

-222 

Data out of range 

The parameter value specified is too large or too small. 

-224 

Illegal parameter value 

The numeric value specified is not allowed. 

-240 

Hardware error 

Error was encountered while attempting to erase Flash ROMs or Flash ROMs 
failed to respond correctly to the programming sequence. 

-252 

Missing media 

No programmable ROM was found, or hardware malfunction. 

-253 

Corrupt media 

An incorrect checksum was read from the programmed ROMs. This is 
indicative of a ROM hardware malfunction or a data transmission error. 

-258 

Media protected 

A command was executed with the "RUN/LOAD" switch in the "RUN" position 
when it should be in the "LOAD" position. 

-310 

System error 

If caused by *DMC, then macro memory is full. 

-350 

Too many errors 

The error queue is full as more than 30 errors have occurred. 
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Table B-2 Error Messages and Causes (continued) 


Error Messages and Causes 


Code Message Cause 

-410 Query interrupted Data is not read from the output buffer before another command is executed. 

-420 Query unterminated Command which generates data not able to finish executing due to a multimeter 

configuration error. 

-430 Query deadlocked Command execution cannot continue since the mainframe’s command input, and data 

output buffers are full. Clearing the instrument restores control. 

+1000 Out of memory There is not enough available Flash ROM to create a FROM 

driver area. 

+1500 External trigger source already "Event In" signal already allocated to another instrument such as a Switchbox, 
allocated 

+2002 Invalid logical address A value less than 0 or greater than 255 was specified for logical address. 

+2003 Invalid word address An odd address was specified for a 16-bit read or 

write. Always use even addresses for 16-bit (word) accesses. 

+2005 No card at logical address A non-existent logical address was specified with the 

VXhREAD? or VXhWRITE command. 

+2013 Word serial protocol error An error has occurred in a word serial protocol command. The program block sent had 

an improper size. 

+2016 Byte count is not a multiple of two A RAM Disc volume was removed after successful programming of the Flash ROMs. 

+2022 Config warning, RAM Disc An attempt was made to install drivers before the 

Volume contents lost 

+2023 Flash driver area not created DIAG:DRIV:INST command was executed. 


+2024 Flash driver area already installed 

+2101 Failed Device 

+2102 Unable to combine device 

+2103 Config warning. Device driver not 
found 


An attempt was made to install drivers after the 
DIAG:DRIV:INST command had already been executed. 

VXI device failed its self test. 

Device type can not be combined into an instrument such as a scanning voltmeter or a 
switchbox. 

ID of device does not match list of drivers available. Warning only. 


+2105 Config error 5, A24 memory More A24 memory installed in the mainframe than can be configured into the available 

overflow A24 memory space. 

+2108 Config error 8, Inaccessible A24 memory device overlaps memory space reserved by the mainframe’s operating 

A24 memory system. 

+2110 Config error 10, Insufficient Too many instruments installed for the amount of RAM installed in the mainframe, 

system memory Cannot configure instruments. Only the system instrument is started. 

+2111 Config error 11, Invalid instrument A device’s logical address is not a multiple of 8 and the device is not part of a combined 
address instrument. 

+2112 Invalid user-defined commander The commander assigned to a device by a user-defined 

logical address 

+2114 Invalid user-defined secondary Configuration Table does not assign it a secondary address. 

address A secondary address assigned by a user configuration table is illegal. 

+2115 Duplicate secondary address A secondary address specified by a user configuration table is used more than once. 
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Error Types 


Table B-2 Error Messages and Causes (continued) 


Error Messages and Causes 


Code Message Cause 

+2116 Invalid servant area The logical address plus servant area of a commander is greater than 255 or greater 

than that of a superior commander within this tree. 

+2117 Slot 0 functions disabled A command module is in slot 0 but slot 0 switches are in the disabled position. 

+2118 Invalid commander logical address A device does not have a valid commander. 

+2119 BNO failed Sending a BEGIN Normal Operation command to a device failed. 

+2120 Write ready timeout A message based device failed to become write ready. 

+2121 Read ready timeout A message based device failed to become read ready. 

+2122 ERR* asserted The ERR* bit is asserted in a device’s response register. 

+2123 END failed Sending an End Normal Operation command to a device failed. 

+2124 Interrupt line unavailable No line is available for a programmable interrupt handler. All lines are used or 

duplicate. 

+2125 Invalid user defined handler The user defined interrupt table specifies a device that is not a programmable 

interrupt handler, or does not exist. 

+2126 Invalid user defined interrupter The user defined interrupt table specifies a device that is not a programmable 

interrupter, or does not exist. 

+2127 Diagnostic mode on GRIB address switch bit 6 is set wrong (warning only). 

+2128 Resource Manager not in Slot 0 A command module is configured for slot 0 and resource manager but is installed in 

another slot (warning only). 

+2129 Warning, Sysfail detected A device was asserting SYSFAIL on the backplane during startup. 

+2130 Pseudo instrument logical address A physical device has the same logical address as IBASIC (240). 

unavailable 

+2131 File system start up failed Insufficient system resources to allow the IBASIC file system to start. 

+2133 Invalid UDEF memory block Invalid memory block in user defined memory table. 

+2134 UDEF memory block unavailable The same base address or memory are specified more than once in the memory table, 

or the addresses in the specified block are already in use. 

+2135 Invalid UDEF address space The address specified in the memory table is A24 but the device is A32, or vice versa. 

+2136 Duplicate UDEF memory LADD A logical address is specified more than once in the memory table. This does not 

apply to VME devices (address = -1). 

+2137 Invalid UDEF CNFG table The valid flag in the command/servant hierarchy table is not set to 1. 

+2138 Invalid UDEF CNFG table data There are more than 254 entries in the commander/servant hierarchy table. 

+2139 Invalid UDEF DC table The valid flag in the dynamic configuration table is not set to 1. 

+2140 Invalid UDEF DC table data There are more than 254 entries in the dynamic configuration table. 

+2141 Invalid UDEF Interrupter The logical address specified for an interrupter is a device that is not an interrupter. 
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Table B-2 Error Messages and Causes (continued) 


Error Messages and Causes 


Code Message Cause 

+2142 Invalid UDEFINTR table The interrupter table valid flag is not 1. 

+2143 Invalid UDEF MEM table The valid flag in the memory table is not set to 1. 

+2144 Invalid UDEF MEM table data An invalid logical address is specified in the memory table. 

+2145 Warning, Non-Volatile RAM Non-volatile RAM was corrupted, a cold boot was executed, or non-volatile RAM 

contents lost was removed after the successful programming of the Flash ROMs. 

+2146 MESG based open access failed I or 14 device is violating VXI specification. 

+2147 Granted device not found A Keysight El 406A which is not a slot zero device or a resource manager could not 

find a module that was granted to its servant area. 

+2148 Config warning 48, Driver Driver RAM was corrupted, a cold boot was executed, or Driver RAM was removed 

RAM contents lost after the successful programming of the Flash ROMs. 

+2149 VME system controller disabled VME SYSTEM CONTROLLER switch is disabled on the Keysight El 406A module. 

+2150 Extender not slot 0 device VXIbus extender in remote mainframe is not in slot 0 of its mainframe. 

+2151 Invalid extender LADD window MXI extender cannot be configured with a valid LADD window. 

+2152 Device outside of LADD window A device is located outside the allowable logical address window range of an 

MXI bus extender. 

+2153 Invalid extender A24 window MXIbus extender cannot be configured with a valid A24 memory window. 

+2154 Device outside of A24 window An A24 memory device is located outside the allowable logical address window 

range of an MXIbus extender. 

+2155 Invalid extender A32 window MXIbus extender cannot be configured with a valid A32 memory window. 

+2156 Device outside of A32 window An A32 memory device is located outside the allowable logical address window 

range of an MXIbus extender. 

+2157 Invalid UDEF LADD window User defined logical address window has incorrect base address or size. 

+2158 Invalid UDEF A16 window User defined A16 memory window has incorrect base address or size. 

+2159 Invalid UDEF A24 window User defined A24 memory window has incorrect base address or size. 

+2160 Invalid UDEF A32 window User defined A32 memory window has incorrect base address or size. 

+2161 Invalid UDEF EXT table The valid flag in the extender table is not set to 1. 

+2162 Invalid UDEF extender table data There are more than 254 records in the extender table. 


+2163 Unsupported UDEF TTL trigger There is an extender table TTL trigger entry for a device which does not support TTL 

triggers. 

+2164 Unsupported UDEF ECL trigger There is an extender table ECL trigger entry for a device which does not support ECL 

triggers. 

+2165 Device not in configure state A message based device was not in CONFIGURE state during reboot. 
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Table B-2 Error Messages and Causes (continued) 


1 Error Messages and Causes 


Code 

Message 

Cause 

+2166 

INTX card not installed 

The INTX daughter card on the VXI-MXI module is not installed or is not functioning 
correctly. 

+2167 

Config warning, Flash ROM 
driver contents lost 

The contents of the Flash ROM driver area have been corrupted. 

+2201 

Unexpected interrupt from 
message based card 

A message based card interrupted when an interrupt service routine has not been set 
up. 

+2202 

Unexpected interrupt from 
non-message based card 

A register based card interrupted when an interrupt service routine had not been set 
up. 

+2809 

Interrupt line has not been set up 

A DIAG:INT:ACT or DIAG:INT:RESP command was executed before setting the interrupt 
with DIAG:INT:SET. 

+2810 

Not a handler for this line 

An attempt was made to set up an interrupt with DIAG:INT:SET for a line that has no 
handler, (see VXI:CONF:ITAB). 
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Start-up Error Messages and Warnings 

start-up error messages and warnings are most often generated just after the 
mainframe is powered-up or rebooted (DIAG:BOOT command). These messages 
can be read from the error queue using the SYST:ERR? command. We 
recommend that you include a routine at the beginning of your application 
programs which checks for start-up errors before the program tries to access 
individual instruments. See your VXIbus Configuration Guide for an example 
program. 


Table B-3 Start-Up Error Messages and Warnings 


1 Start-Up Error Messages and Warnings 


Code 

Message 

Cause 

1 

Failed Device 

VXl device failed its self test. 

2 

Unable to combine device 

Device type can not be combined into an instrument such as a scanning 
voltmeter or a switchbox. 

3 

Config warning, Device driver not 
found 

ID of device does not match list of drivers available. Warning only. 

4 

DC device block too big 

Dynamically configured device address block is greater than 127. 

5 

Config error 5, A24 memory 
overflow 

More A24 memory is installed in the mainframe than can be configured into the 
available A24 memory space. 

6 

A32 memory overflow 

More A32 memory is installed in the mainframe than can be configured into the 
available A32 memory space. 

7 

DC device move failed 

A dynamically configured device failed to move to a new logical address. 

8 

Config error 8, Inaccessible A24 
memory 

An A24 memory device overlaps a memory space reserved by the mainframe’s 
operating system. 

9 

Unable to move DC device 

The block size for a set of address-blocked Dynamically Configured devices is 
too large for the available space or an attempt was made to move a Dynamically 
Configured device to an already assigned Logical Address.Cannot configure 
instruments. Only the system instrument is started. 
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Table B-3 Start-Up Error Messages and Warnings (continued) 


Start-Up Error Messages and Warnings 


Code 

Message 

Cause 

10 

Config error 10, Insufficient 
system memory 

Too many instruments installed for the amount of RAM installed in the mainframe. 
Cannot configure instruments. Only the system instrument is started. 

11 

Config error 11, Invalid instrument 
address 

A device’s logical address is not a multiple of 8 and the device is not part of a 
combined instrument. 

12 

Invalid user defined commander 
logical address 

The commander assigned to a device by a user defined Configuration Table does not 
assign it a secondary address. 

14 

Invalid user defined secondary 
address 

A secondary address assigned by a user configuration table is illegal. 

15 

Duplicate secondary address 

A secondary address specified by a user configuration table is used more than once. 

16 

Invalid servant area 

The logical address plus servant area of a commander is greater than 255 or greater 
than that of a superior commander within this tree. 

17 

Slot 0 functions disabled 

A command module is in slot 0 but slot 0 switches are in the disabled position. 

18 

Invalid commander logical address 

A device does not have a valid commander. 

19 

BNO failed 

Sending a BEGIN Normal Operation command to a device failed. 

20 

Write ready timeout 

A message based device failed to become write ready. 

21 

Read ready timeout 

A message based device failed to become read ready. 

22 

ERR* asserted 

The ERR* bit is asserted in a device’s response register. 

23 

END failed 

Sending an End Normal Operation command to a device failed. 

24 

Interrupt line unavailable 

No line is available for a programmable interrupt handler. All lines are used or 
duplicate. 

25 

Invalid user defined handler 

The user defined interrupt table specifies a device that is not a programmable 
interrupt handler, or does not exist. 

26 

Invalid user defined interrupter 

The user defined interrupt table specifies a device that is not a programmable 
interrupter, or does not exist. 

27 

Diagnostic mode on 

GPIB address switch bit 6 is set wrong (warning only). 

28 

Resource Manager not in Slot 0 

A command module is configured for slot 0 and resource manager but is installed in 
another slot (warning only). 

29 

Warning, Sysfail detected 

A device was asserting SYSFAIL on the backplane during start-up. 

30 

Pseudo instrument logical address 
unavailable 

A physical device has the same logical address as IBASIC (240). 

31 

File system startup failed 

Insufficient system resources to allow the IBASIC file system to start. 

32 

Inaccessible A32 memory 

Device has A32 memory below 20000000016 or above DFFFFFFF16 

33 

Invalid UDEF memory block 

Invalid memory block in user defined Memory table. 

34 

UDEF memory block unavailable 

The same base address or memory are specified more than once in the memory table, 
or the addresses in the specified block are already in use. 

35 

Invalid UDEF address space 

The address specified in the memory table is A24 but the device is A32, or vice versa. 
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Table B-3 Start-Up Error Messages and Warnings (continued) 


Start-Up Error Messages and Warnings 
Code Message 

36 Duplicate UDEF memory LADD 

37 Invalid UDEF CNFG table 

38 Invalid UDEF CNFG table data 

39 Invalid UDEF DC table 

40 Invalid UDEF DC table data 

41 Invalid UDEF Interrupter 

42 Invalid UDEF INTR table 

43 Invalid UDEF MEM table 

44 Invalid UDEF MEM table data 

45 Warning, NVRAM contents lost 

46 MESG based open access failed 

47 Granted device not found 

48 Warning, DRAM contents lost 

49 VME system controller disabled 

50 Extender not slot 0 device 

51 Invalid extender LADD window 

52 Device outside of LADD window 

53 Invalid extender A24 window 

54 Device outside of A24 window 

55 Invalid extender A32 window 

56 Device outside of A32 window 

57 Invalid UDEF LADD window 

58 Invalid UDEF A16 window 

59 Invalid UDEF A24 window 

60 Invalid UDEF A32 window 


Cause 

A logical address is specified more than once in the memory table. This does not 
apply to VME devices (address = -1). 

The valid flag in the command/servant hierarchy table is not set to 1. 

There are more than 254 entries in the commander/servant hierarchy table. 

The valid flag in the dynamic configuration table is not set to 1. 

There are more than 254 entries in the dynamic configuration table. 

The logical address specified for an interrupter is a device that is not an interrupter. 
The interrupter table valid flag is not 1. 

The valid flag in the memory table is not set to 1. 

An invalid logical address is specified in the memory table. 

NVRAM was corrupted or a cold boot was executed. 

I or 14 device is violating VXI specification. 


Driver RAM was corrupted or a cold boot was executed. 

VME SYSTEM CONTROLLER switch is disabled on the Keysight El 406A module. 

VXIbus extender in remote mainframe is not in slot 0 of its mainframe. 

MXI extender cannot be configured with a valid LADD window. 

A device is located outside the allowable logical address window range of an MXIbus 
extender. 

MXIbus extender cannot be configured with a valid A24 memory window. 

An A24 memory device is located outside the allowable logical address window range 
of an MXIbus extender. 

MXIbus extender cannot be configured with a valid A32 memory window. 

An A32 memory device is located outside the allowable logical address window range 
of an MXIbus extender. 

User defined logical address window has incorrect base address or size. 

User defined A16 memory window has incorrect base address or size. 

User defined A24 memory window has incorrect base address or size. 

User defined A32 memory window has incorrect base address or size. 
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Table B-3 Start-Up Error Messages and Warnings (continued) 


1 Start-Up Error Messages and Warnings I 

Code 

Message 

Cause 

61 

Invalid UDEF EXT table 

The valid flag in the extender table is not set to 1. 

62 

Invalid UDEF extender table data 

There are more than 254 records in the extender table. 

63 

Unsupported UDEF TTL trigger 

There is an extender table TTL trigger entry for a device which does not support TTL 
triggers. 

64 

Unsupported UDEF ECL trigger 

There is an extender table ECL trigger entry for a device which does not support ECL 
triggers. 

65 

Device not in configure state 

A message based device was not in CONFIGURE state during reboot. 

66 

INTXcard not installed 

The INTX daughter card on the VXI-MXI module is not installed or is not functioning 
correctly. 

67 

Flash ROM driver contents lost 

The contents of the Flash ROM driver area have been corrupted. 
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C Keysight E1406A Command 
Module A16 Address Space 


About This Appendix 

Many Keysight Technologies VXIbus devices are register-based devices which do 
not support the VXIbus word serial protocol. When an SCPI command is sent to a 
register-based device, the E1406A Command Module parses the command and 
programs the device at the register level. 

Register-based programming is a series of reads and writes directly to the device 
registers. This increases throughput since it eliminates command parsing. 

This appendix contains an address map of A16 address space in the command 
module. It shows how to determine the base address and register offset for 
register-based devices mapped into A16 space. Refer to the individual plug-in 
module manuals for details on device is programming at the register level. 


E1300/E1405/E1406 
ADDRESS MAP 


FTTFFF,6 


EOOOOOie 


2OOOOO16 

iFOOOOifi 


OOOOOO 16 


A24 

ADDRESS 

SPACE 


^ / 
/ 



Register Map 


* Bose Address = IFC000,6 + (logicol dddress ” 64)15 

or 
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Figure C-1 El 406A Command Module A16 Address Space 
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Register Addressing 

Register addresses for register-based devices are located in the upper 25% of 
VXI A16 address space. Every VXI device (up to 256 devices per Command 
Module) is allocated a 64 byte block of addresses. A device may or may not use 
the entire block of addresses. Figure C-1 shows the location of A16 address 
space in the Keysight E1406A Command Module. 

The Base Address 

When you are reading or writing to a device register, a hexadecimal or decimal 
register address is specified. This address consists of a base address plus a 
register offset. 

Determining the Base Address 

The base address of a device in A16 address space is computed as: 

1FC00016 + (LADDR*64)16 
or 

2,080,76810 + (LADDR* 64)10 

where 1 FC00016 (2,080,76810) is the starting location of the VXI A16 addresses, 
LADDR is the device’s logical address, and 64 is the number of address bytes per 
register-based device. For example, the Keysight El 411B multimeter has a 
factory set logical address of 24. If this address is not changed, the multimeter 
will have a base address of: 

1FC00016 + (24*64)16 

1 FCOOOl6 + 60016 = 1 FC60016 

or 

2,080,76810 + (24*64)10 
2,080,76810 + 153610 = 2,082,30410 

Register Offset 

The register offset is the register’s location in the block of 64 address bytes. 

For example, the Keysight El 411 B multimeter’s Command Register has an 

offset of 0816. When you write a command to this register, the offset is added to 
the base address to form the register address: 

1FC60016 + 0816 = 1FC60816 
or 

2,082,30410 + 810 = 2,082,31210 
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About This Appendix 

This appendix describes the procedure for sending pure binary data over an 
RS-232 interface. The formatting described is used in the 
DIAG:DOWN:CHEC[:MADD], DIAG:DOWN:CHEC:SADD, and 
DIAG:DRIV:LOAD:CHEC commands. This appendix contains the following main 
sections. 


Formatting Binary Data for RS-232 Transmission page 307 
Sending Binary Data Over RS-232 page 309 

Formatting Binary Data for RS-232 Transmission 

The most straightforward way to send a block of data is to open the data file, 
read the next byte from the file, and send it to the System Instrument until you 
reach the end of file. However, binary data cannot be sent to the system 
instrument as is. It must be converted into a format that will not conflict with the 
special characters that the RS-232 interface recognizes. This is done by sending 
only one half byte (a nibble) at a time. 

To prevent this nibble from being confused with a special character, bit 7 of the 
nibble is set to one. This gives all data bytes in the block values greater than 127 
so they are not confused with ASCII characters. It also doubles 

the size of the file to be sent and the transmission time for the file. Since a 
transmission errorthat required re-transmission of the entire data block would be 
very time consuming, a 3-bit error code (which allows for correction of single bit 
errors) is added to the transmission byte. The following format is sent for each 
nibble: 


Bit# 

7 

6 5 4 

3 

2 1 

0 

1 

Correction Code 

Data 
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Formatting Binary Data for RS-232 Transmission 


The error correction code is based on the nibble of data sent. The easiest way to 
implement this code is to use Table D-1. It is indexed based on the value of the 
nibble to send out, so there are 16 elements to the table. 


Table D-1 Correction Codes for RS-232 Transmission 


Data Value 

Correction 

Byte in Hex 

Byte in 


Code 


Decimal 

0 

0 

8016 

128 

1 

7 

F116 

241 

2 

6 

E216 

226 

3 

1 

9316 

147 

4 

5 

D416 

212 

5 

2 

A516 

165 

6 

3 

B616 

182 

7 

4 

C716 

199 

8 

3 

B816 

184 

9 

4 

C916 

201 

10 

5 

DAI 6 

218 

11 

2 

AB16 

171 

12 

6 

EC16 

236 

13 

1 

9D16 

157 

14 

0 

8E16 

142 

15 

7 

FF16 

255 
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Sending Binary Data Over RS-232 

The RS-232 interface differs from the GPIB interface in that there is no device 
addressing built into the interface definition. Device addressing must be done on 
top of the RS-232 functions. This addressing is done through the same 
mechanism as the terminal-based front panel, and must be done either by the 
transfer program or manually before starting the transfer program. 

Setting Up the Mainframe 

There are two commands (SI - Select Instrument and SA - Select Address) that 
can be used at the Select an instrument interface. The Select an instrument 
interface can always be reached by sending the CTRL-D character (ASCII 4) over 
the RS-232 line. Once there, the System instrument can be reached by sending 
the command SI SYSTEM followed by a carriage return. All output after this 
command will be directed to/from the System instrument until another CTRL-D 
is received. The following sequence will make sure that the mainframe is set up 
and ready. 

1 Send CTRL-D (ASCII 4) to get to the Select an instrument interface. 

2 Send ST UNKNOWN and a carriage return to insure that the interface is set to 
dumb terminal mode. 

3 Send SI SYSTEM and a carriage return to get the attention of the System 
instrument. 

4 Send CTRL-C to clear the system. 

5 Send *RST and a carriage return to put the System instrument in a known 
state. 

The program must then send the binary data. This block of data should include 
the command DIAG:DOWN:CHEC followed by the address to download to, and 
an IEEE 488.2 arbitrary block header. This block header can be either definite or 
indefinite. The advantage of using an indefinite block header is that you do not 
need to know the length of the data block. The indefinite block header is #0. With 
the DIAG:DOWN:CHEC command, an indefinite block is terminated with the T" 
character followed by a carriage return. The T" character is not considered part 
of the block. 

A definite block only requires the ASCII carriage return character as terminator. 
The definite block starts with #. This is followed by a single digit that shows the 
number of digits in the length field, which is followed by the actual length of the 
block, not counting the header. For instance, a block of 1000 bytes would have a 
definite block header of #41000. Due to the formatting required, the size of the 
block when using the DIAG:DOWN:CHEC command is twice the length of the 
data in bytes. 
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Sending Binary Data Over RS-232 


Once the block header has been sent, the actual data is sent. Since the buffer 
size of the System instrument RS-232 Interface is limited to 79 bytes, the buffer 
must be flushed (passed to an instrument parser) before it reaches 79 bytes. This 
can be done by sending a carriage return. The first carriage return should be 
included in the binary file after the buffer header. Sending it before this would 
result in the parser determining that there are not enough parameters and 
producing an error condition. Once transmission of the actual data begins, a 
carriage return should be included after every 78 bytes. 


NOTE 


The carriage returns are not considered part of the block count. 


After the last byte of data, there must be a carriage return to terminate the 
transmission for a definite block or a T" and carriage return for an indefinite 
block. 
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